EnableRouter-Funktion (iphlpapi.h)

Artikel
08/24/2023

Die Funktion EnableRouter aktiviert die IPv4-Weiterleitung auf dem lokalen Computer. EnableRouter erhöht auch eine Verweisanzahl, die die Anzahl der Anforderungen zum Aktivieren der IPv4-Weiterleitung nachverfolgt.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD EnableRouter(
  HANDLE     *pHandle,
  OVERLAPPED *pOverlapped
);

Parameter

pHandle

Ein Zeiger auf ein Handle. Dieser Parameter wird derzeit nicht verwendet.

pOverlapped

Ein Zeiger auf eine Struktur OVERLAPPED. Mit Ausnahme des hEvent-Members sollten alle Member dieser Struktur auf 0 festgelegt werden. Das hEvent-Element sollte ein Handle für ein gültiges Ereignisobjekt enthalten. Verwenden Sie die CreateEvent-Funktion , um dieses Ereignisobjekt zu erstellen.

Rückgabewert

Wenn die EnableRouter-Funktion erfolgreich ist, wird der Rückgabewert ERROR_IO_PENDING.

Wenn die Funktion fehlschlägt, verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Einer der Parameter ist ungültig. Dieser Fehler wird zurückgegeben, wenn der pOverlapped-ParameterNULL ist.
Andere	Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die EnableRouter-Funktion ist spezifisch für die IPv4-Weiterleitung. Wenn der Prozess, der EnableRouter aufruft, beendet wird, ohne UnenableRouter aufzurufen, erhöht das System die Verweisanzahl, die die Anzahl der Anforderungen zum Aktivieren der IPv4-Weiterleitung nachverfolgt, als hätte der Prozess UnenableRouter aufgerufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll