INtime SDK Help
DeleteRtMemoryHandle
INtime SDK v7 > About INtime > INtime Kernel > Memory management > DeleteRtMemoryHandle

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

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

See Also

Memory management system calls, CreateRtMemoryHandle