Zugriff auf undurchsichtige Zeiger

Clients können mithilfe von undurchsichtigen Zeigern auf die in Zielzielen gespeicherten Informationen zugreifen. Um den Speicher zu verwenden, muss der Client zuerst RtmGetOpaqueInformationPointer aufrufen, um den Zeiger abzurufen. Wenn eine Änderung an den Informationen erforderlich ist, muss der Client zuerst das Ziel sperren, indem rtmLockDestination mit dem auf TRUE festgelegten LockDest-Parameter aufgerufen wird. Sobald das Ziel gesperrt ist, kann der Client die erforderliche Änderung vornehmen. Das Ziel kann mit einem anderen Aufruf von RtmLockDestination mit dem auf FALSE festgelegten LockDest-Parameter entsperrt werden.

Die RtmLockDestination-Funktion ermöglicht es einem Client auch, eine Lesesperre oder eine Schreibsperre mit dem exklusiven Parameter zu verwenden. Ein Client sollte die Schreibsperre nur verwenden, wenn änderungen an den Informationen vorgenommen werden, die mit dem undurchsichtigen Zeiger aufbewahrt werden. Clients können die Lesesperre verwenden, um die in einem Ziel gespeicherten undurchsichtigen Zeigerinformationen anzuzeigen.

Beispielcode, der die Verwendung dieser Funktionen veranschaulicht, finden Sie unter Access the Opaque Pointer in a Destination.