PGET_INTERFACE_INFO función de devolución de llamada (routprot.h)
La función GetInterfaceInfo obtiene la información de configuración que mantiene el protocolo de enrutamiento para una interfaz específica.
Sintaxis
PGET_INTERFACE_INFO PgetInterfaceInfo;
DWORD PgetInterfaceInfo(
[in] ULONG InterfaceIndex,
[in] PVOID InterfaceInfo,
[in, out] PULONG BufferSize,
[in] PULONG StructureVersion,
[in] PULONG StructureSize,
[in] PULONG StructureCount
)
{...}
Parámetros
[in] InterfaceIndex
Especifica la interfaz en el conjunto de interfaces configuradas en el enrutador.
[in] InterfaceInfo
Puntero a un búfer que recibe la información de configuración definida por el protocolo asociada a la interfaz. Esta información es privada para el protocolo de enrutamiento.
[in, out] BufferSize
Puntero a una variable DWORD .
En la entrada: esta variable especifica el tamaño, en bytes, del búfer proporcionado para recibir la información de configuración.
En la salida: esta variable recibe el tamaño, en bytes, de los datos colocados en el búfer. Si el tamaño inicial no era lo suficientemente grande, esta variable contiene el tamaño necesario para contener todos los datos.
[in] StructureVersion
Especifica la versión de las estructuras de información a las que apunta el parámetro InterfaceInfo . En algunos casos, esto es igual a la versión del protocolo de enrutamiento.
[in] StructureSize
Especifica el tamaño de cada una de las estructuras de información a las que apunta el parámetro InterfaceInfo . Dado que algunas estructuras de información contienen miembros de longitud variable, el protocolo de enrutamiento no es necesariamente capaz de determinar el tamaño de la información de la versión.
[in] StructureCount
Especifica un recuento del número de estructuras de información a las que apunta el parámetro InterfaceInfo . Este parámetro siempre es uno.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Descripción |
|---|---|
|
Error al intentar recuperar la información. |
|
El parámetro InterfaceIndex no es válido (por ejemplo, no existe ninguna interfaz con ese índice) o el parámetro InterfaceInfoSize es NULL. |
|
El tamaño del búfer de salida proporcionado no es lo suficientemente grande como para contener la información solicitada. El tamaño necesario se devuelve en la variable DWORD a la que apunta InterfaceInfoSize. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | routprot.h |
Consulte también
Funciones de interfaz de protocolo de enrutamiento