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.
Met de functie SetUnicastIpAddressEntry worden de eigenschappen van een bestaande unicast-IP-adresvermelding op een lokale computer ingesteld.
Syntaxis
NETIOAPI_API SetUnicastIpAddressEntry(
_In_ const MIB_UNICASTIPADDRESS_ROW *Row
);
Parameters
-
rij [in]
Een aanwijzer naar een MIB_UNICASTIPADDRESS_ROW structuurvermelding voor een bestaande unicast-IP-adresvermelding.
Retourwaarde
SetUnicastIpAddressEntry- retourneert STATUS_SUCCESS als de functie slaagt.
Als de functie mislukt, retourneert SetUnicastIpAddressEntry 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_UNICASTIPADDRESS_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_UNICASTIPADDRESS_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_UNICASTIPADDRESS_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. |
| Overige | Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen. |
Opmerkingen
De functie GetUnicastIpAddressEntry- wordt meestal gebruikt om een bestaande MIB_UNICASTIPADDRESS_ROW structuurvermelding op te halen die moet worden gewijzigd. Een stuurprogramma kan vervolgens de leden in de MIB_UNICASTIPADDRESS_ROW vermelding wijzigen die het wil wijzigen en vervolgens de functie SetUnicastIpAddressEntry aanroepen.
Een stuurprogramma kan de functie InitializeUnicastIpAddressEntry aanroepen om de leden van een MIB_UNICASTIPADDRESS_ROW structuurvermelding te initialiseren met standaardwaarden voordat u wijzigingen aanbrengt. Het stuurprogramma slaat echter meestal de InterfaceLuid- of InterfaceIndex lid op voordat u InitializeUnicastIpAddressEntry aanroept en een van deze leden herstelt na de aanroep.
Het stuurprogramma moet de volgende leden van de MIB_UNICASTIPADDRESS_ROW-structuur initialiseren waarnaar de parameter rij 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. 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.
Als de OnLinkPrefixLength lid van de MIB_UNICASTIPADDRESS_ROW-structuur waarnaar de parameter rij verwijst, is ingesteld op 255, SetUnicastIpAddressEntry- de unicast-IP-adreseigenschappen zo in dat de OnLinkPrefixLength lid gelijk is aan de lengte van het IP-adres. Voor een unicast IPv4-adres is OnLinkPrefixLength- ingesteld op 32. Voor een unicast IPv6-adres is OnLinkPrefixLength- ingesteld op 128. Als deze instellingen resulteren in het onjuiste subnetmasker voor een IPv4-adres of het onjuiste koppelingsvoorvoegsel voor een IPv6-adres, moet het stuurprogramma dit lid instellen op de juiste waarde voordat het aanroepen van SetUnicastIpAddressEntry-.
SetUnicastIpAddressEntry negeert de DadState, ScopeIden CreationTimeStamp leden van de MIB_UNICASTIPADDRESS_ROW-structuur waarnaar de parameter Row verwijst. Deze leden worden ingesteld door de netwerkstack en kunnen niet worden gewijzigd met behulp van de functie SetUnicastIpAddressEntry. Het ScopeId lid wordt automatisch bepaald door de interface waarop het adres is toegevoegd.
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 |