Deletes a memory handle created with CreateRtMemoryHandle.

BOOLEAN DeleteRtMemoryHandle(
    RTHANDLE hSeg,    // Handle to delete
);

Parameters

hSeg

RTHANDLE for a shared memory area which was previously created with CreateRtMemoryHandle.

Remarks

Memory that was addressed by the RT handle is not returned to the memory pool. The GDT slot is returned to the memory manager for reassignment.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_EXIST 0x0006

You used an invalid value for hSeg.

E_TYPE 0x8002

hSeg requires an RT handle for a shared RT memory area.

E_INVALID_ADDRESS 0x00E2

The address provided for the remote object is not a valid address.

Requirements

See Also

Memory management system calls, CreateRtMemoryHandle