Función InitializeIpInterfaceEntry
La función InitializeIpInterfaceEntry inicializa los miembros de una entrada de estructura 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. Cuando se devuelve 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 ejecuta 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 NULL en el parámetro fila de |
| otros | Use la función FormatMessage para obtener la cadena del mensaje para el error devuelto. |
Observaciones
En la salida, los miembros de la estructura de MIB_IPINTERFACE_ROW a los que apunta el parámetro row se inicializan de la manera siguiente.
de familia
Establezca en AF_UNSPEC.interfaceLuid
Establézcalo en un valor no especificado.Todos los demás miembros
Establézcalo 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 |