InitializeUnicastIpAddressEntry-Funktion
Die InitializeUnicastIpAddressEntry-Funktion initialisiert eine MIB_UNICASTIPADDRESS_ROW-Struktur mit Standardwerten für einen Unicast-IP-Adresseintrag auf einem lokalen Computer.
Syntax
VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
_Out_ PMIB_UNICASTIPADDRESS_ROW Row
);
Parameter
- Zeile [out]
Beim Eintrag ein Zeiger auf einen MIB_UNICASTIPADDRESS_ROW-Struktureintrag für einen Unicast-IP-Adresseintrag. Bei der Rückgabe wird die MIB_UNICASTIPADDRESS_ROW Struktur, auf die dieser Parameter verweist, mit Standardwerten für eine Unicast-IP-Adresse initialisiert.
Rückgabewert
Keine
Bemerkungen
Ihr Treiber muss die InitializeUnicastIpAddressEntry-Funktion verwenden, um die Member eines MIB_UNICASTIPADDRESS_ROW-Struktureintrags mit Standardwerten für eine Unicast-IP-Adresse zur späteren Verwendung mit der CreateUnicastIpAddressEntry-Funktion zu initialisieren.
Bei der Eingabe muss Ihr Treiber InitializeUnicastIpAddressEntry eine neue MIB_UNICASTIPADDRESS_ROW Struktur übergeben, die initialisiert werden soll.
Bei der Ausgabe werden die Member der MIB_UNICASTIPADDRESS_ROW-Struktur, auf die der Row-Parameter verweist, wie folgt initialisiert.
PrefixOrigin
Legen Sie auf den IpPrefixOriginUnchanged-Wert der NL_PREFIX_ORIGIN-Enumeration fest.SuffixOrigin
Legen Sie auf den IpSuffixOriginUnchanged-Wert der NL_PREFIX_ORIGIN-Enumeration fest.OnLinkPrefixLength
Auf einen unzulässigen Wert festgelegt.PreferredLifetime und ValidLifetime
Auf unendliche Werte festgelegt.SkipAsSource
Legen Sie auf FALSE fest.Alle anderen Mitglieder
Auf NULL festlegen.
Nachdem ein Treiber InitializeUnicastIpAddressEntry aufgerufen hat, kann der Treiber die Member im MIB_UNICASTIPADDRESS_ROW Eintrag ändern, den er ändern möchte, und dann CreateUnicastIpAddressEntry aufrufen, um die neue Unicast-IP-Adresse dem lokalen Computer hinzuzufügen.
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 |