CreateIpNetEntry-Funktion (iphlpapi.h)

Artikel
08/24/2023

Die CreateIpNetEntry-Funktion erstellt einen ARP-Eintrag (Address Resolution Protocol) in der ARP-Tabelle auf dem lokalen Computer.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD CreateIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parameter

[in] pArpEntry

Ein Zeiger auf eine MIB_IPNETROW-Struktur , die Informationen für den neuen Eintrag angibt. Der Aufrufer muss Werte für alle Member dieser Struktur angeben.

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
ERROR_ACCESS_DENIED	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.
ERROR_INVALID_PARAMETER	Ein Eingabeparameter ist ungültig, es wurde keine Aktion ausgeführt. Dieser Fehler wird zurückgegeben, wenn der pArpEntry-ParameterNULL ist, der dwPhysAddrLen-Member von MIB_IPNETROW auf null oder einen Wert größer als 8 festgelegt ist, das >dwAddr-Element der MIB_IPNETROW-Struktur ungültig ist oder eines der anderen Member der MIB_IPNETROW-Struktur ungültig ist.
ERROR_NOT_SUPPORTED	Der IPv4-Transport ist auf dem lokalen Computer nicht konfiguriert.
Andere	Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Verwenden Sie die SetIpNetEntry-Funktion , um einen vorhandenen ARP-Eintrag zu ändern. Rufen Sie die GetIpNetTable-Funktion auf, um die ARP-Tabelle abzurufen. Um einen vorhandenen ARP-Eintrag zu löschen, rufen Sie DeleteIpNetEntry auf.

Unter Windows Vista und höher kann die CreateIpNetEntry-Funktion nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn CreateIpNetEntry von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl, und ERROR_ACCESS_DENIED wird zurückgegeben.

Die CreateIpNetEntry-Funktion kann auch aufgrund der Benutzerkontensteuerung (UAC) unter Windows Vista später 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 der Anwendung 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.

Hinweis Unter Windows NT 4.0 und Windows 2000 und höher führt diese Funktion einen privilegierten Vorgang aus. Damit diese Funktion erfolgreich ausgeführt werden kann, muss der Aufrufer als Mitglied der Gruppe Administratoren oder der Gruppe NetworkConfigurationOperators angemeldet sein.

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