RtmGetOpaqueInformationPointer-Funktion (rtmv2.h)

  • Artikel

Die RtmGetOpaqueInformationPointer-Funktion gibt einen Zeiger auf das undurchsichtige Informationsfeld in einem Ziel zurück, das für diesen Client reserviert ist. Mit dem Zeiger kann der Client clientspezifische Informationen mit dem Ziel in der Routingtabelle speichern.

Syntax

DWORD RtmGetOpaqueInformationPointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PVOID             *OpaqueInfoPointer
);

Parameter

[in] RtmRegHandle

Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] DestHandle

Handle bis zum Ziel.

[out] OpaqueInfoPointer

Bei der Eingabe ist OpaqueInfoPointer ein Zeiger auf NULL.

Bei der Ausgabe empfängt OpaqueInfoPointer einen Zeiger auf den undurchsichtigen Informationszeiger. Wenn ein Client während der Registrierung keinen undurchsichtigen Zeiger reserviert hat, bleibt dieser Parameter unverändert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert Bedeutung
ERROR_INVALID_HANDLE
 Das Handle ist ungültig.
ERROR_NOT_FOUND
 Vom Client wurde kein undurchsichtiger Zeiger reserviert.
 
 

Hinweise

Beispielcode mit dieser Funktion finden Sie unter Zugreifen auf den undurchsichtigen Zeiger in einem Ziel.

Anforderungen

   
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile rtmv2.h
Bibliothek Rtm.lib
DLL Rtm.dll

Weitere Informationen

RtmLockDestination