Udostępnij przez


InitializeUnicastIpAddressEntry, funkcja

Funkcja InitializeUnicastIpAddressEntry inicjuje strukturę MIB_UNICASTIPADDRESS_ROW z wartościami domyślnymi dla wpisu adresu IP emisji pojedynczej na komputerze lokalnym.

Składnia

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parametry

  • wiersz [out]
    Podczas wprowadzania wskaźnik do wpisu struktury MIB_UNICASTIPADDRESS_ROW dla wpisu adresu IP emisji pojedynczej. Po powrocie struktura MIB_UNICASTIPADDRESS_ROW wskazująca ten parametr jest inicjowana z wartościami domyślnymi dla adresu IP emisji pojedynczej.

Wartość zwracana

Żaden

Uwagi

Sterownik musi użyć funkcji InitializeUnicastIpAddressEntry, aby zainicjować elementy członkowskie wpisu struktury MIB_UNICASTIPADDRESS_ROW z wartościami domyślnymi dla adresu IP emisji pojedynczej do późniejszego użycia z funkcją CreateUnicastIpAddressEntry.

W danych wejściowych sterownik musi przekazać InitializeUnicastIpAddressEntry nową strukturę MIB_UNICASTIPADDRESS_ROW, aby zainicjować.

W danych wyjściowych elementy członkowskie struktury MIB_UNICASTIPADDRESS_ROW, do których wskazuje wiersz, są inicjowane w następujący sposób.

  • prefiks Origin
    Ustaw wartość IpPrefixOriginUnchanged wyliczenia NL_PREFIX_ORIGIN.

  • sufiks Origin
    Ustaw wartość IpSuffixOriginUnchanged wyliczenia NL_PREFIX_ORIGIN.

  • OnLinkPrefixLength
    Ustaw wartość na niedozwoloną.

  • PreferredLifetime i ValidLifetime
    Ustaw wartość na wartości nieskończone.

  • SkipAsSource
    Ustaw wartość FALSE.

  • Wszyscy inni członkowie
    Ustaw wartość zero.

Po wywołaniu sterownika InitializeUnicastIpAddressEntrysterownik może następnie zmienić elementy członkowskie we wpisie MIB_UNICASTIPADDRESS_ROW, który chce zmodyfikować, a następnie wywołać CreateUnicastIpAddressEntry, aby dodać nowy adres IP emisji pojedynczej do komputera lokalnego.

Wymagania

Platforma docelowa

universal

Wersja

Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.

Nagłówek

Netioapi.h (include Netioapi.h)

Biblioteka

Netio.lib

IRQL

< DISPATCH_LEVEL

Zobacz też

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry