Función InitializeIpInterfaceEntry
La función InitializeIpInterfaceEntry inicializa los miembros de una entrada de estructura de MIB_IPINTERFACE_ROW con valores predeterminados.
Sintaxis
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
Parámetros
- Fila [in, out]
Puntero a una estructura de MIB_IPINTERFACE_ROW que se va a inicializar. Si la devolución se realiza correctamente, los campos de este parámetro se inicializan con información predeterminada para una interfaz en el equipo local.
Valor devuelto
InitializeIpInterfaceEntry devuelve STATUS_SUCCESS si la función se realiza correctamente.
Si se produce un error en la función, InitializeIpInterfaceEntry devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro Row . |
| Otros | Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Observaciones
En la salida, los miembros de la estructura MIB_IPINTERFACE_ROW a los que apunta el parámetro Row se inicializan de la siguiente manera.
Familia
Establezca en AF_UNSPEC.InterfaceLuid
Se establece en un valor no especificado.Todos los demás miembros
Establecer en cero.
El controlador debe usar la función InitializeIpInterfaceEntry para inicializar los campos de una entrada de estructura de MIB_IPINTERFACE_ROW con valores predeterminados. A continuación, un controlador puede cambiar los campos de la entrada MIB_IPINTERFACE_ROW que quiere modificar y, a continuación, llamar a la función SetIpInterfaceEntry .
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 |