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

Removes an entry from a process' object directory.

You remove entries from a directory using the UncatalogRtHandle system call.

BOOLEAN UncatalogRtHandle(
    RTHANDLE hProcess,    // handle for RT process
    LPSTR lpszName        // pointer to object name
);

Parameters

hProcess
Handle for an RT process. A value of NULL_RTHANDLE may be used to indicate the current process.
lpszName
Pointer to a zero-terminated, ASCII string containing the name of an object in the given process' directory.

Return Values

TRUE
Success.
FALSE
Failure. To determine the status, call GetLastRtError.

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 hProcess.
E_TYPE 0x8002
hProcess is not a process handle.
E_BAD_ADDR 0x800F
lpszName is invalid.
E_INVALID_ADDRESS 0x00E2
The address provided for the remote object is not a valid address.

Requirements

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