CreateAnycastIpAddressEntry-Funktion
Die CreateAnycastIpAddressEntry-Funktion fügt einen neuen Anycast-IP-Adresseintrag auf einem lokalen Computer hinzu.
Syntax
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parameter
- Zeile [in]
Ein Zeiger auf einen MIB_ANYCASTIPADDRESS_ROW-Struktureintrag für einen Anycast-IP-Adresseintrag.
Rückgabewert
CreateAnycastIpAddressEntry gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, gibt CreateAnycastIpAddressEntry einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Row-Parameter übergeben wird, der Address-Member der MIB_ANYCASTIPADDRESS_ROW-Struktur , auf die der Row-Parameter verweist, nicht auf eine gültige Unicast-IPv4- oder IPv6-Adresse festgelegt wurde oder die Member InterfaceLuid und InterfaceIndex der MIB_ANYCASTIPADDRESS_ROW-Struktur nicht angegeben wurden. |
| STATUS_NOT_FOUND | Die angegebene Schnittstelle konnte nicht gefunden werden. Dieser Fehler wird zurückgegeben, wenn die Funktion die Netzwerkschnittstelle nicht finden kann, die vom InterfaceLuid - oder InterfaceIndex-Member der MIB_UNICASTIPADDRESS_ROW Struktur angegeben wird, auf die der Row-Parameter verweist. |
| STATUS_NOT_SUPPORTED | Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich kein IPv4-Stapel auf dem lokalen Computer befindet und eine IPv4-Adresse im Address-Member der MIB_ANYCASTIPADDRESS_ROW-Struktur angegeben wurde, auf die der Row-Parameter verweist, oder wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und im Address-Member eine IPv6-Adresse angegeben wurde. |
| ERROR_OBJECT_ALREADY_EXISTS | Das Objekt ist bereits vorhanden. Dieser Fehler wird zurückgegeben, wenn der Address-Member der MIB_ANYCASTIPADDRESS_ROW Struktur, auf die der Row-Parameter verweist, ein Duplikat einer vorhandenen Anycast-IP-Adresse auf der Schnittstelle ist, die vom InterfaceLuid - oder InterfaceIndex-Member der MIB_ANYCASTIPADDRESS_ROW-Struktur angegeben wird. |
| Andere | Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Bemerkungen
Ihr Treiber muss die folgenden Member der MIB_ANYCASTIPADDRESS_ROW-Struktur initialisieren, auf die der Row-Parameter verweist.
Adresse
Legen Sie auf eine gültige Unicast-IPv4- oder IPv6-Adresse und -Familie fest.InterfaceLuid oder InterfaceIndex
Diese Member werden in der zuvor aufgeführten Reihenfolge verwendet. Wenn Also InterfaceLuid angegeben ist, wird dieser Member verwendet, um die Schnittstelle zu bestimmen, der die Unicast-IP-Adresse hinzugefügt werden soll. Wenn kein Wert für das InterfaceLuid-Element festgelegt wurde (der Wert dieses Members wurde auf 0 festgelegt), wird als Nächstes das InterfaceIndex-Element verwendet, um die Schnittstelle zu bestimmen.
Das ScopeId-Element der MIB_ANYCASTIPADDRESS_ROW Struktur, auf die der Row-Parameter verweist, wird ignoriert, wenn die CreateAnycastIpAddressEntry-Funktion aufgerufen wird. Das ScopeId-Element wird automatisch von der Schnittstelle bestimmt, auf der die Adresse hinzugefügt wird.
Die CreateAnycastIpAddressEntry-Funktion schlägt fehl, wenn die anycast-IP-Adresse, die im Address-Member der MIB_ANYCASTIPADDRESS_ROW-Struktur übergeben wird, auf die der Row-Parameter verweist, ein Duplikat einer vorhandenen anycast-IP-Adresse auf der Schnittstelle ist.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |