Funzione InitializeUnicastIpAddressEntry

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

Sintassi

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parametri

• riga [out]
  All'ingresso, un puntatore a una voce di struttura MIB_UNICASTIPADDRESS_ROW per una voce di indirizzo IP unicast. In caso di restituzione, la struttura MIB_UNICASTIPADDRESS_ROW a cui punta questo parametro viene inizializzata con i valori predefiniti per un indirizzo IP unicast.

Valore restituito

Nessuno

Osservazioni

Il driver deve usare la funzione InitializeUnicastIpAddressEntry per inizializzare i membri di una voce di struttura MIB_UNICASTIPADDRESS_ROW con valori predefiniti per un indirizzo IP unicast da usare successivamente con la funzione CreateUnicastIpAddressEntry.

All'input, il driver deve passare InitializeUnicastIpAddressEntry una nuova struttura MIB_UNICASTIPADDRESS_ROW da inizializzare.

Nell'output, i membri della struttura MIB_UNICASTIPADDRESS_ROW a cui punta il parametro riga vengono inizializzati come indicato di seguito.

• PrefixOrigin
  Impostare sul valore IpPrefixOriginUnchanged dell'enumerazione NL_PREFIX_ORIGIN.

• SuffissoOrigin
  Impostare sul valore ipSuffixOriginUnchanged dell'enumerazione NL_PREFIX_ORIGIN.

• OnLinkPrefixLength
  Impostare su un valore non valido.

• PreferredLifetime e ValidLifetime
  Impostare su valori infiniti.

• SkipAsSource
  Impostare su FALSE.

• Tutti gli altri membri
  Impostare su zero.

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

Fabbisogno

Piattaforma di destinazione	universale
Versione	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	Netioapi.h (include Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL

Vedere anche

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry