Compartir a través de


Función InitializeUnicastIpAddressEntry (netioapi.h)

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

Consulte también

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

Referencia de la función auxiliar de IP

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry