Função MprConfigInterfaceGetHandle (mprapi.h)

Artigo
03/13/2024

A função MprConfigInterfaceGetHandle recupera um identificador para a configuração da interface especificada na configuração do roteador especificada.

Sintaxe

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

Parâmetros

[in] hMprConfig

Manipule para a configuração do roteador. Obtenha esse identificador chamando MprConfigServerConnect.

[in] lpwsInterfaceName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da interface para a qual o identificador de configuração é solicitado. Use o GUID da interface como o nome de uma interface LAN.

[out] phRouterInterface

Ponteiro para uma variável de identificador. Essa variável recebe um identificador para a configuração da interface.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor	Significado
ERROR_INVALID_PARAMETER	O parâmetro hMprConfig é NULL ou o parâmetro lpwsInterfaceName é NULL ou ambos os parâmetros são NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_NO_SUCH_INTERFACE	A interface especificada não foi encontrada na configuração do roteador.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll

Confira também

FormatMessage

MprConfigServerConnect

Funções de configuração do roteador

Referência de gerenciamento de roteador

Compartilhar via