Funzione InitializeUnicastIpAddressEntry (netioapi.h)

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

Vedi anche

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

Informazioni di riferimento sulla funzione helper IP

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry