Función InitializeUnicastIpAddressEntry

La función InitializeUnicastIpAddressEntry inicializa una estructura de MIB_UNICASTIPADDRESS_ROW con valores predeterminados para una entrada de dirección IP de unidifusión en un equipo local.

Sintaxis

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parámetros

• fila [out]
  En la entrada, un puntero a una entrada de estructura MIB_UNICASTIPADDRESS_ROW para una entrada de dirección IP de unidifusión. A cambio, la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta este parámetro se inicializa con valores predeterminados para una dirección IP de unidifusión.

Valor devuelto

Ninguno

Observaciones

El controlador debe usar la función InitializeUnicastIpAddressEntry para inicializar los miembros de una entrada de estructura de MIB_UNICASTIPADDRESS_ROW con valores predeterminados para una dirección IP de unidifusión para su uso posterior con la función CreateUnicastIpAddressEnt ry.

En la entrada, el controlador debe pasar InitializeUnicastIpAddressEntry una nueva estructura de MIB_UNICASTIPADDRESS_ROW para inicializar.

En la salida, los miembros de la estructura de MIB_UNICASTIPADDRESS_ROW a los que apunta el parámetro row se inicializan de la siguiente manera.

• prefijoOrigin
  Establézcalo en el IpPrefixOriginUnchanged valor de la enumeración NL_PREFIX_ORIGIN.

• sufijoOrigin
  Establezca en el valor de IpSuffixOriginUnchanged de la enumeración NL_PREFIX_ORIGIN.

• onLinkPrefixLength
  Se establece en un valor no válido.

• PreferredLifetime y ValidLifetime
  Establezca en valores infinitos.

• SkipAsSource
  Establezca en false.

• Todos los demás miembros
  Establézcalo en cero.

Después de que un controlador llame a InitializeUnicastIpAddressEntry, el controlador puede cambiar los miembros de la entrada MIB_UNICASTIPADDRESS_ROW que desea modificar y, a continuación, llamar al CreateUnicastIpAddressEntry para agregar la nueva dirección IP de unidifusión al equipo local.

Requisitos

Consulte también

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry