Función InitializeUnicastIpAddressEntry (netioapi.h)

Artículo
03/15/2023

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 el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

Parámetros

[out] Row

En la entrada, un puntero a una entrada de estructura de MIB_UNICASTIPADDRESS_ROW para una entrada de dirección IP de unidifusión. A cambio, la estructura de 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

Esta función no devuelve ningún valor.

Observaciones

La función InitializeUnicastIpAddressEntry se define en Windows Vista y versiones posteriores.

La función InitializeUnicastIpAddressEntry debe usarse 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 CreateUnicastIpAddressEntry .

En la entrada, InitializeUnicastIpAddressEntry debe pasarse una nueva estructura de MIB_UNICASTIPADDRESS_ROW para inicializar.

En la salida, el miembro PrefixOrigin de la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro Row se inicializará en IpPrefixOriginUnchanged, el miembro SuffixOrigin Se inicializará en IpSuffixOriginUnchanged y el miembro OnLinkPrefixLength se inicializará en un valor no válido. Además, los miembros PreferredLifetime y ValidLifetime se establecen en infinitos, el miembro SkipAsSource se establece en FALSE y otros campos se inicializan en cero.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netioapi.h (incluya Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll