RtmBlockMethods-Funktion (rtmv2.h)

Artikel
03/13/2024

Die RtmBlockMethods-Funktion blockiert oder hebt die Blockierung der Ausführung von Methoden für ein angegebenes Ziel, eine route oder einen angegebenen nächsten Hop oder für alle Ziele, Routen und nächsten Hops auf.

Syntax

DWORD RtmBlockMethods(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] HANDLE            TargetHandle,
  [in] UCHAR             TargetType,
  [in] DWORD             BlockingFlag
);

Parameter

[in] RtmRegHandle

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

[in] TargetHandle

Handle an ein Ziel, eine Route oder einen nächsten Hop, für den Methoden blockiert werden sollen. Dieser Parameter ist optional und kann auf NULL festgelegt werden, um Methoden für alle Ziele zu blockieren.

[in] TargetType

Gibt den Typ des Handles in TargetHandle an. Dieser Parameter ist optional und kann auf NULL festgelegt werden, um Methoden für alle Ziele zu blockieren. Die folgenden Flags werden verwendet.

Typ	Bedeutung
DEST_TYPE	TargetHandle ist ein Ziel.
NEXTHOP_TYPE	TargetHandle ist ein nächster Hop.
ROUTE_TYPE	TargetHandle ist eine Route.

[in] BlockingFlag

Gibt an, ob Methoden blockiert oder aufgehoben werden sollen. Die folgenden Flags werden verwendet.

Konstante	Bedeutung
RTM_BLOCK_METHODS	Blockmethoden für das angegebene Ziel.
RTM_RESUME_METHODS	Heben Sie die Blockierung von Methoden für das angegebene Ziel auf.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert der folgende Fehlercode.

Wert	Bedeutung
ERROR_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Derzeit unterstützt diese Funktion keine Blockierungsmethoden für ein bestimmtes Ziel, eine bestimmte Route oder einen bestimmten nächsten Hop.

Methoden werden in der Regel blockiert, wenn clientspezifische Daten in der Route geändert werden. Ein Client blockiert Methoden, ordnet Daten neu an und hebt dann die Blockierung von Methoden auf.

Clients sollten Methoden nur für einen kurzen Zeitraum blockieren. Wenn ein zweiter Client RtmInvokeMethod aufruft und die Methoden des ersten Clients blockiert werden, gibt RtmInvokeMethod erst zurück, wenn die Blockierung der Methoden aufgehoben und der Funktionsaufruf abgeschlossen ist.

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

RtmGetEntityMethods

RtmInvokeMethod

Freigeben über