INtime SDK Help
GetRtHandleType
INtime SDK v6 > About INtime > INtime Kernel > Object Directories > GetRtHandleType

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

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib
See Also