Sdílet prostřednictvím


InitializeUnicastIpAddressEntry – funkce

Funkce InitializeUnicastIpAddressEntry inicializuje strukturu MIB_UNICASTIPADDRESS_ROW s výchozími hodnotami pro položku IP adresy jednosměrového vysílání v místním počítači.

Syntax

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parametry

  • řádek [out]
    Ukazatel na položku MIB_UNICASTIPADDRESS_ROW struktury pro položku IP adresy jednosměrového vysílání. Při návratu se MIB_UNICASTIPADDRESS_ROW struktura, na kterou tento parametr odkazuje, inicializuje s výchozími hodnotami pro IP adresu jednosměrového vysílání.

Návratová hodnota

Žádný

Poznámky

Ovladač musí použít funkci InitializeUnicastIpAddressEntry k inicializaci členů položky struktury MIB_UNICASTIPADDRESS_ROW s výchozími hodnotami pro IP adresu jednosměrového vysílání pro pozdější použití s funkcí CreateUnicastIpAddressEntry.

Na vstupu musí ovladač předat InitializeUnicastIpAddressEntry novou strukturu MIB_UNICASTIPADDRESS_ROW pro inicializaci.

Ve výstupu jsou členy struktury MIB_UNICASTIPADDRESS_ROW, na které řádek body parametrů inicializován následujícím způsobem.

  • PrefixOrigin
    Nastavte na hodnotu IpPrefixOriginUnchanged výčtu NL_PREFIX_ORIGIN.

  • přípony
    Nastavte na hodnotu IpSuffixOriginUnchanged výčtu NL_PREFIX_ORIGIN.

  • onLinkPrefixLength
    Nastavte na neplatnou hodnotu.

  • preferredLifetime a ValidLifetime
    Nastavte na nekonečné hodnoty.

  • SkipAsSource
    Nastavte na hodnotu FALSE.

  • Všichni ostatní členové
    Nastavte na nulu.

Jakmile ovladač zavolá InitializeUnicastIpAddressEntry, ovladač může změnit členy v položce MIB_UNICASTIPADDRESS_ROW, kterou chce upravit, a potom zavolat CreateUnicastIpAddressEntry přidat novou IP adresu jednosměrového vysílání do místního počítače.

Požadavky

Cílová platforma

univerzální

Verze

K dispozici v systémech Windows Vista a novějších verzích operačních systémů Windows.

Záhlaví

Netioapi.h (včetně Netioapi.h)

Knihovna

Netio.lib

IRQL

< DISPATCH_LEVEL

Viz také

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry