Obtains an NTXHANDLE that corresponds to an RTHANDLE. See Handle conversion.

NTXHANDLE ntxImportRtHandle(
    RTHANDLE IncomingObject,
    NTXHANDLE hObjectSource
);

Parameters

IncomingObject

RTHANDLE in question.

hObjectSource

NTXHANDLE of the object from which IncomingObject was obtained. For example, if the RTHANDLE was stored in an address space, then pass that address space's NTXHANDLE in hObjectSource.

Return Values

A new NTXHANDLE referring to the same RT object as the RTHANDLE.

Success.

NTX_BAD_NTXHANDLE

Failure. To determine the status, call ntxGetLastRtError.

Status

E_EXIST 0x0006

IncomingObject or hObjectSource does not contain a valid handle.

E_LOCATION

The location of hObjectSource cannot be determined or is invalid.

Requirements