CreateProxyArpEntry-Funktion (iphlpapi.h)
Die CreateProxyArpEnry-Funktion erstellt einen PARP-Eintrag (Proxy Address Resolution Protocol) auf dem lokalen Computer für die angegebene IPv4-Adresse.
Syntax
IPHLPAPI_DLL_LINKAGE DWORD CreateProxyArpEntry(
[in] DWORD dwAddress,
[in] DWORD dwMask,
[in] DWORD dwIfIndex
);
Parameter
[in] dwAddress
Die IPv4-Adresse, für die dieser Computer als Proxy fungiert.
[in] dwMask
Die Subnetzmaske für die in dwAddress angegebene IPv4-Adresse.
[in] dwIfIndex
Der Index der Schnittstelle, auf der ARP als Proxy für die von dwAddress identifizierte IPv4-Adresse verwendet werden soll. Anders ausgedrückt: Wenn eine ARP-Anforderung für dwAddress auf dieser Schnittstelle empfangen wird, antwortet der lokale Computer mit der physischen Adresse dieser Schnittstelle. Wenn diese Schnittstelle einen Typ aufweist, der ARP nicht unterstützt, z. B. PPP, schlägt der Aufruf fehl.
Rückgabewert
Die Funktion gibt NO_ERROR (null) zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zugriff wird verweigert. Dieser Fehler wird unter Windows Vista und Windows Server 2008 unter folgenden Bedingungen zurückgegeben: Dem Benutzer fehlen die erforderlichen Administratorrechte auf dem lokalen Computer, oder die Anwendung wird nicht in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausgeführt. |
|
Ein Eingabeparameter ist ungültig, es wurde keine Aktion ausgeführt. Dieser Fehler wird zurückgegeben, wenn der dwAddress-Parameternull oder ein ungültiger Wert ist, einer der anderen Parameter ungültig ist. |
|
Der IPv4-Transport ist auf dem lokalen Computer nicht konfiguriert. |
|
Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen. |
Hinweise
Rufen Sie die GetIpNetTable-Funktion auf, um die ARP-Tabelle abzurufen. Um einen vorhandenen PARP-Eintrag zu löschen, rufen Sie DeleteProxyArpEntry auf.
Unter Windows Vista und höher kann die CreateProxyArpEnry-Funktion nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn CreateProxyArpEnry von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl, und ERROR_ACCESS_DENIED wird zurückgegeben. Diese Funktion kann auch aufgrund der Benutzerkontensteuerung (User Account Control, UAC) unter Windows Vista und höher fehlschlagen. Wenn eine Anwendung, die diese Funktion enthält, von einem Benutzer ausgeführt wird, der als Mitglied der Gruppe Administratoren angemeldet ist, die nicht der integrierten Administratorgruppe angehört, schlägt dieser Aufruf fehl, es sei denn, die Anwendung wurde in der Manifestdatei mit einem requestedExecutionLevel gekennzeichnet, der auf requireAdministrator festgelegt ist. Wenn in der Anwendung unter Windows Vista und später diese Manifestdatei fehlt, muss ein Benutzer, der sich als Mitglied der Gruppe "Administratoren" angemeldet hat als der integrierte Administrator, die Anwendung dann in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausführen, damit diese Funktion erfolgreich ist.
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 |