EnableRouter-Funktion (iphlpapi.h)
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 |
|---|---|
|
Einer der Parameter ist ungültig. Dieser Fehler wird zurückgegeben, wenn der pOverlapped-ParameterNULL ist. |
|
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 |