Funzione InitializeUnicastIpAddressEntry

Articolo
03/08/2023

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 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 per usarlo successivamente con la funzione CreateUnicastIpAddressEntry .

Nell'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 Row vengono inizializzati come indicato di seguito.

PrefixOrigin
Impostare sul valore IpPrefixOriginUnchangeddell'enumerazione NL_PREFIX_ORIGIN .
SuffissoOrigin
Impostare sul valore IpSuffixOriginUnchangeddell'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
Imposta su zero.

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

Requisiti

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