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

Removes an entry from a process' object directory.

NTXSTATUS ntxUncatalogNtxHandle( 
    NTXHANDLE hRtProcess, 
    NTXHANDLE hObject, 
    LPSTR lpszName
);

Parameters

hRtProcess
Handle for an RT process.
hObject
Handle for the object to uncatalog.
lpszName
Pointer to a zero-terminated, ASCII string containing the name of an object in the given process' directory.

Return Values

E_OK
Success.
The status code.
Failure.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_PARAM 0x8004
lpszName contains a string with a length of 0 (zero) or greater than 12.
E_CONTEXT 0x0005
The specified object directory does not contain an entry with the designated name.
E_EXIST 0x0006
You used an invalid value for hRtProcess.
E_TYPE 0x8002
hRtProcess does not contain a process handle.
E_BAD_ADDR 0x800F
lpszName is invalid.

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