RtmDeleteNextHop-Funktion (rtmv2.h)

Artikel
08/25/2023

Die RtmDeleteNextHop-Funktion löscht einen nächsten Hop aus der Next-Hop-Liste.

Syntax

DWORD RtmDeleteNextHop(
  [in] RTM_ENTITY_HANDLE  RtmRegHandle,
  [in] RTM_NEXTHOP_HANDLE NextHopHandle,
  [in] PRTM_NEXTHOP_INFO  NextHopInfo
);

Parameter

[in] RtmRegHandle

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

[in] NextHopHandle

Handle bis zum nächsten zu löschenden Hop. Dieser Parameter ist optional und kann auf NULL festgelegt werden. wenn es NULL ist, werden die Werte in NextHopInfo verwendet, um den nächsten zu löschenden Hop zu identifizieren.

[in] NextHopInfo

Zeiger auf eine Struktur, die Informationen enthält, die den nächsten zu löschenden Hop identifizieren. Dieser Parameter ist optional und kann auf NULL festgelegt werden. wenn es NULL ist, wird das Handle in NextHopHandle verwendet, um den nächsten zu löschenden Hop zu identifizieren.

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 diesen nächsten Hop nicht.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang abzuschließen.
ERROR_NOT_FOUND	Der angegebene nächste Hop wurde nicht gefunden.

Hinweise

Wenn ein Client ein NextHopHandle angibt, sollte der Client das Handle anschließend nicht mithilfe von RtmReleaseNextHops freigeben.

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

Freigeben über