RtmMarkDestForChangeNotification-Funktion (rtmv2.h)

Artikel
03/01/2024

Die RtmMarkDestForChangeNotification-Funktion markiert ein Ziel für einen Client. Ein markiertes Ziel gibt dem Routingtabellen-Manager an, dass die Clientänderungsbenachrichtigungen für das markierte Ziel gesendet werden sollen. Der Client empfängt Änderungsbenachrichtigungen, wenn sich ein Ziel ändert. Die Änderungsbenachrichtigungen informieren den Client über Änderungen an Informationen zur besten Route für das angegebene Ziel. Diese Funktion sollte verwendet werden, wenn RtmRegisterForChangeNotification aufgerufen wird, um Änderungen für bestimmte Ziele (RTM_NOTIFY_ONLY_MARKED_DESTS) anzufordern.

Syntax

DWORD RtmMarkDestForChangeNotification(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              MarkDest
);

Parameter

[in] RtmRegHandle

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

[in] NotifyHandle

Behandeln Sie eine Änderungsbenachrichtigung, die über einen vorherigen Aufruf von RtmRegisterForChangeNotification abgerufen wurde.

[in] DestHandle

Behandeln Sie das Ziel, das der Client für die Benachrichtigung über Änderungen markiert.

[in] MarkDest

Gibt an, ob ein Ziel markiert und Änderungsbenachrichtigungen empfangen werden sollen. Geben Sie TRUE an, um ein Ziel zu markieren und Änderungsbenachrichtigungen für das angegebene Ziel zu empfangen. Geben Sie FALSE an, um den Empfang von Änderungsbenachrichtigungen für ein zuvor markiertes Ziel zu beenden.

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.

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