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