RtmLockDestination-Funktion (rtmv2.h)

  • Artikel

Die RtmLockDestination-Funktion sperrt oder entsperrt ein Ziel in der Routingtabelle. Verwenden Sie diese Funktion, um ein Ziel zu schützen, während Sie undurchsichtige Zeiger ändern.

Syntax

DWORD RtmLockDestination(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              Exclusive,
  [in] BOOL              LockDest
);

Parameter

[in] RtmRegHandle

Handle mit dem Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] DestHandle

Handle bis zum zu sperrenden Ziel.

[in] Exclusive

Gibt an, ob das Ziel in einem exklusiven Modus (TRUE) oder freigegeben (FALSE) gesperrt oder entsperrt werden soll.

[in] LockDest

Gibt an, ob das Ziel gesperrt oder entsperrt werden soll. Geben Sie TRUE an, um das Ziel zu sperren. Geben Sie FALSE an, um sie zu entsperren.

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_ACCESS_DENIED
 Der aufrufende Client besitzt dieses Ziel nicht.
ERROR_INVALID_HANDLE
 Das Handle ist ungültig.
 
 

Hinweise

Diese Funktion sperrt auch die zugeordneten Routen. Vermeiden Sie das Sperren von Zielen für lange Zeiträume, da kein anderer Client auf das Ziel und die zugeordneten Routen zugreifen kann, bis die Sperre aufgehoben wird.

Ein Client kann diese Funktion auch beim Lesen von Informationen für ein Ziel verwenden und gleichzeitig Änderungen während des Lesevorgangs des Clients verhindern. In diesem Fall sollten Sie stattdessen RtmGetDestInfo verwenden.

Beispielcode mit dieser Funktion finden Sie unter Aktualisieren einer Route An Ort mithilfe von RtmUpdateAndUnlockRoute.

Anforderungen

Anforderung Wert
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

RtmGetOpaqueInformationPointer