Returns the number of bytes in a previously allocated memory area.

DWORD GetRtSize(
  RTHANDLE hSeg    // RTHANDLE for previously-created memory area
);

Parameters

Remarks

Segments can be a maximum length of 4 Gbytes.

Return Values

A DWORD value giving the number of bytes in the segment.

If hSeg is the data segment of an XM process, then the returned value will be 0xffffffff, indicating a size of 4 GB.

Success.

0 (zero)

Failure. The handle passed in is invalid, or is not a segment handle. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_EXIST 0x0006

hSeg is not a handle for an existing object.

E_TYPE 0x8002

hSeg is not a handle for a memory object.

Requirements

Memory management system calls