Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
Funktionen CreateAnycastIpAddressEntry lägger till en ny anycast IP-adresspost på en lokal dator.
Syntax
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parametrar
-
rad [in]
En pekare till en MIB_ANYCASTIPADDRESS_ROW strukturpost för en anycast IP-adresspost.
Returvärde
CreateAnycastIpAddressEntry returnerar STATUS_SUCCESS om funktionen lyckas.
Om funktionen misslyckas returnerar CreateAnycastIpAddressEntry någon av följande felkoder:
| Returnera kod | Beskrivning |
|---|---|
| STATUS_INVALID_PARAMETER | En ogiltig parameter skickades till funktionen. Det här felet returneras om en NULL- pekare skickas i parametern Rad. -adressen medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parametern pekar på inte har angetts till en giltig unicast IPv4- eller IPv6-adress, eller både InterfaceLuid och InterfaceIndex medlemmar i MIB_ANYCASTIPADDRESS_ROW-strukturen var ospecificerade. |
| STATUS_NOT_FOUND | Det gick inte att hitta det angivna gränssnittet. Det här felet returneras om funktionen inte kan hitta nätverksgränssnittet som anges av InterfaceLuid eller InterfaceIndex medlem i den MIB_UNICASTIPADDRESS_ROW struktur som rad parameter pekar på. |
| STATUS_NOT_SUPPORTED | Begäran stöds inte. Det här felet returneras om ingen IPv4-stack finns på den lokala datorn och en IPv4-adress angavs i -adressen medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parameter pekar på, eller om ingen IPv6-stack finns på den lokala datorn och en IPv6-adress angavs i adress medlem. |
| ERROR_OBJECT_ALREADY_EXISTS | Objektet finns redan. Det här felet returneras om -adressen medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som Rad parametern pekar på är en dubblett av en befintlig anycast IP-adress i gränssnittet som anges av InterfaceLuid eller InterfaceIndex medlem i MIB_ANYCASTIPADDRESS_ROW-strukturen. |
| Andra | Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet. |
Anmärkningar
Drivrutinen måste initiera följande medlemmar i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parametern pekar på.
adress
Ange till en giltig unicast IPv4- eller IPv6-adress och -familj.InterfaceLuid eller InterfaceIndex
Dessa medlemmar används i den ordning som anges tidigare. Så om InterfaceLuid anges används den här medlemmen för att fastställa vilket gränssnitt som unicast-IP-adressen ska läggas till i. Om inget värde har angetts för InterfaceLuid medlem (värdet för den här medlemmen har angetts till noll) används InterfaceIndex medlem för att fastställa gränssnittet.
ScopeId medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parametern pekar på ignoreras när funktionen CreateAnycastIpAddressEntry anropas. ScopeId- medlem bestäms automatiskt av gränssnittet som adressen läggs till på.
Funktionen CreateAnycastIpAddressEntry misslyckas om den anycast-IP-adress som skickas i -adressen medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som Rad parameter pekar på är en dubblett av en befintlig anycast IP-adress i gränssnittet.
Krav
Målplattform |
Universell |
Version |
Finns i Windows Vista och senare versioner av Windows-operativsystemen. |
Rubrik |
Netioapi.h (inkludera Netioapi.h) |
Bibliotek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |