Returns a value indicating the type of an RT object. The handle must be for a valid RT object. If the handle is for a reference object, this call returns the type of the target object.

WORD GetRtHandleType(
    RTHANDLE hObject    // handle for RT object
);

Parameters

hObject

Handle for valid RT object.

Return Values

Returns a value indicating the type of object whose handle was given:

Value	Handle Type
PROCESS_TYPE	Process
THREAD_TYPE	Thread
MAILBOX_TYPE	Mailbox
SEMAPHORE_TYPE	Semaphore
REGION_TYPE	Region
SEGMENT_TYPE	Memory Segment
HEAP_TYPE	Heap
PORT_TYPE	Port
SERVICE_TYPE	Service object
ALARM_TYPE	Alarm object
QUEUE_TYPE	Queue object
RSL_OBJECT_TYPE	RSL object
RSL_REFERENCE_TYPE	RSL reference object
FILE_TYPE	File object
WIN_FILE_TYPE	Windows file object
IWIN32_OBJECT_TYPE	iWin32 object
IWIN32_ANCHOR_TYPE	iWin32 anchor object

Other values may be returned for application-specific objects.

The value INVALID_TYPE is returned where hObject does not refer to a valid INtime object.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_EXIST 0x0006

You used an invalid value for hObject.

Requirements