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 |