Función MprConfigInterfaceGetHandle (mprapi.h)

La función MprConfigInterfaceGetHandle recupera un identificador de la configuración de la interfaz especificada en la configuración del enrutador especificado.

Sintaxis

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

Parámetros

[in] hMprConfig

Controle la configuración del enrutador. Obtenga este identificador llamando a MprConfigServerConnect.

[in] lpwsInterfaceName

Puntero a una cadena Unicode terminada en null que especifica el nombre de la interfaz para la que se solicita el identificador de configuración. Use el GUID de interfaz como nombre de una interfaz LAN.

[out] phRouterInterface

Puntero a una variable de identificador. Esta variable recibe un identificador para la configuración de la interfaz.

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	Significado
ERROR_INVALID_PARAMETER	El parámetro hMprConfig es NULL o el parámetro lpwsInterfaceName es NULL o ambos parámetros son NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_NO_SUCH_INTERFACE	No se encontró la interfaz especificada en la configuración del enrutador.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

 

 

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	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll

Consulte también

FormatMessage

MprConfigServerConnect

Funciones de configuración del enrutador

Referencia de administración de enrutadores