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 [salida]
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 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
None
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 CreateUnicastIpAddressEntry .
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 MIB_UNICASTIPADDRESS_ROW a los que apunta el parámetro Row se inicializan de la siguiente manera.
PrefixOrigin
Establezca en el valor IpPrefixOriginUnchanged de la enumeración NL_PREFIX_ORIGIN .SufijoOrigin
Establezca en el valor IpSuffixOriginUnchanged de la enumeración NL_PREFIX_ORIGIN .OnLinkPrefixLength
Establézcalo en un valor no válido.PreferredLifetime y ValidLifetime
Establezca en valores infinitos.SkipAsSource
Establézcalo en FALSE.Todos los demás miembros
Establecer 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 a CreateUnicastIpAddressEntry para agregar la nueva dirección IP de unidifusión al equipo local.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |