Funzione InitializeUnicastIpAddressEntry (netioapi.h)

Articolo
08/25/2023

La funzione InitializeUnicastIpAddressEntry inizializza una struttura MIB_UNICASTIPADDRESS_ROW con valori predefiniti per una voce di indirizzo IP unicast nel computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

Parametri

[out] Row

In ingresso, un puntatore a una voce di struttura MIB_UNICASTIPADDRESS_ROW per una voce di indirizzo IP unicast. In caso di ritorno, la struttura MIB_UNICASTIPADDRESS_ROW puntata da questo parametro viene inizializzata con valori predefiniti per un indirizzo IP unicast.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

La funzione InitializeUnicastIpAddressEntry viene definita in Windows Vista e versioni successive.

La funzione InitializeUnicastIpAddressEntry deve essere usata per inizializzare i membri di una voce di struttura MIB_UNICASTIPADDRESS_ROW con valori predefiniti per un indirizzo IP unicast per un uso successivo con la funzione CreateUnicastIpAddressEntry .

In input, InitializeUnicastIpAddressEntry deve essere passato un nuovo MIB_UNICASTIPADDRESS_ROW struttura per inizializzare.

Nell'output, il membro PrefixOrigin della struttura MIB_UNICASTIPADDRESS_ROW puntato dal parametro Row verrà inizializzato in IpPrefixOriginUnchanged, il membro SuffixOrigin verrà inizializzato in IpSuffixOriginUnchanged e il membro OnLinkPrefixLength verrà inizializzato in un valore illegale. Inoltre, i membri PreferredLifetime e ValidLifetime sono impostati su infinito, il membro SkipAsSource è impostato su FALSE e altri campi vengono inizializzati su zero.

Dopo aver chiamato InitializeUnicastIpAddressEntry, un'applicazione può quindi modificare i membri nella voce MIB_UNICASTIPADDRESS_ROW che desidera modificare e quindi chiamare CreateUnicastIpAddressEntry per aggiungere il nuovo indirizzo IP unicast al computer locale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	netioapi.h (includere Iphlpapi.h)
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll