INtime SDK Help
ntxGetType
INtime SDK v7 > About INtime > INtime Kernel > Object Directories > ntxGetType

Returns the type of an NTX handle.

WORD ntxGetType(
    NTXHANDLE hObject
);

Parameters

hObject
Handle to the object in question.

Return Values

Returns the type of the object indicated by the input handle, or NTX_ERROR on error.

Possible type values are listed in this table:

Value Handle Type
NTX_TYPE_RT_PROCESS Process
NTX_TYPE_RT_THREAD Thread
NTX_TYPE_MAILBOX Mailbox
NTX_TYPE_RT_SEMAPHORE Semaphore
NTX_TYPE_RT_SHARED_MEMORY Shared Memory Segment
NTX_TYPE_REGION Single-unit Semaphore with special suspension, deletion, and priority-adjustment features
NTX_TYPE_EXTENSION User defined object
NTX_TYPE_PORT Port Object
NTX_TYPE_POOL The contiguous chunk of physical memory available to the process
NTX_TYPE_HEAP Memory Segment for dynamic allocation. Taken from the pool
NTX_TYPE_SERVICE Service Object
   
NTX_ERROR
Failure. To determine the status, call ntxGetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_EXIST 0x0006
The object parameter is not a handle for an existing object.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib
   
See Also