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 |