Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De functie CreateAnycastIpAddressEntry voegt een nieuwe anycast-IP-adresvermelding toe op een lokale computer.
Syntaxis
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parameters
-
rij [in]
Een aanwijzer naar een MIB_ANYCASTIPADDRESS_ROW structuurvermelding voor een anycast-IP-adresvermelding.
Retourwaarde
CreateAnycastIpAddressEntry- retourneert STATUS_SUCCESS als de functie slaagt.
Als de functie mislukt, retourneert CreateAnycastIpAddressEntry een van de volgende foutcodes:
| Retourcode | Beschrijving |
|---|---|
| STATUS_INVALID_PARAMETER | Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd als een NULL- aanwijzer wordt doorgegeven in de parameter rij, het adres lid van de MIB_ANYCASTIPADDRESS_ROW-structuur waarnaar de parameter rij verwijst, niet is ingesteld op een geldig IPv4- of IPv6-adres van unicast, of zowel InterfaceLuid- als InterfaceIndex leden van de MIB_ANYCASTIPADDRESS_ROW-structuur zijn niet opgegeven. |
| STATUS_NOT_FOUND | Kan de opgegeven interface niet vinden. Deze fout wordt geretourneerd als de functie de netwerkinterface die is opgegeven door de InterfaceLuid of InterfaceIndex niet kan vinden lid van de MIB_UNICASTIPADDRESS_ROW-structuur waarnaar de parameter Rij verwijst. |
| STATUS_NOT_SUPPORTED | De aanvraag wordt niet ondersteund. Deze fout wordt geretourneerd als er geen IPv4-stack zich op de lokale computer bevindt en er een IPv4-adres is opgegeven in het -adres lid van de MIB_ANYCASTIPADDRESS_ROW-structuur waarnaar de parameter rij verwijst, of als er geen IPv6-stack op de lokale computer staat en er een IPv6-adres is opgegeven in het adres lid. |
| ERROR_OBJECT_ALREADY_EXISTS | Het object bestaat al. Deze fout wordt geretourneerd als het -adres lid van de MIB_ANYCASTIPADDRESS_ROW-structuur waarnaar de parameter rij verwijst, een duplicaat is van een bestaand anycast-IP-adres op de interface die is opgegeven door de InterfaceLuid- of InterfaceIndex lid van de MIB_ANYCASTIPADDRESS_ROW-structuur. |
| Overige | Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen. |
Opmerkingen
Uw stuurprogramma moet de volgende leden van de MIB_ANYCASTIPADDRESS_ROW-structuur initialiseren waarnaar de rij parameter verwijst.
adres
Ingesteld op een geldig unicast-IPv4- of IPv6-adres en -gezin.InterfaceLuid of InterfaceIndex
Deze leden worden gebruikt in de volgorde die eerder wordt vermeld. Dus als InterfaceLuid- is opgegeven, wordt dit lid gebruikt om de interface te bepalen waaraan het unicast-IP-adres moet worden toegevoegd. Als er geen waarde is ingesteld voor het InterfaceLuid lid (de waarde van dit lid is ingesteld op nul), wordt de InterfaceIndex lid naast het bepalen van de interface gebruikt.
Het ScopeId lid van de MIB_ANYCASTIPADDRESS_ROW-structuur waarnaar de parameter row wijst, wordt genegeerd wanneer de functie CreateAnycastIpAddressEntry wordt aangeroepen. Het ScopeId lid wordt automatisch bepaald door de interface waarop het adres is toegevoegd.
De functie CreateAnycastIpAddressEntry mislukt als het anycast-IP-adres dat wordt doorgegeven in het -adres lid van de MIB_ANYCASTIPADDRESS_ROW-structuur waarnaar de parameter Rij verwijst, een duplicaat is van een bestaand anycast-IP-adres op de interface.
Eisen
Doelplatform |
Universal |
Versie |
Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen. |
Rubriek |
Netioapi.h (inclusief Netioapi.h) |
Bibliotheek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |