Função MprConfigInterfaceTransportGetHandle (mprapi.h)

Artigo
03/13/2024

A função MprConfigInterfaceTransportGetHandle recupera um identificador para a configuração de transporte de uma interface na configuração do roteador especificada.

Sintaxe

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Parâmetros

[in] hMprConfig

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

[in] hRouterInterface

Manipule para a configuração da interface. Obtenha esse identificador chamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle ou MprConfigInterfaceEnum.

[in] dwTransportId

Um valor DWORD que descreve o tipo de identificador de configuração de transporte no parâmetro phRouterIfTransport . Os valores aceitáveis para dwTransportId estão listados na tabela a seguir.

Valor	Transporte (Família de Protocolos)
PID_ATALK	Appletalk
PID_IP	Protocolo internet versão 4
PID_IPX	Troca de Pacotes da Internet
PID_NBF	Protocolo NetBIOS Frames
PID_IPV6	Windows Server 2008 ou posterior: Protocolo de Internet versão 6

[out] phRouterIfTransport

Um ponteiro para um
Variável HANDLE que recebe o tipo de identificador de configuração de transporte para essa interface indicada no parâmetro dwTransportId .

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	Pelo menos um dos seguintes é verdadeiro: hMprConfig é NULL. hRouterInterface é NULL. phRouterIfTransport é NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_NO_SUCH_INTERFACE	A interface especificada por hRouterInterface não foi encontrada na configuração do roteador ou o transporte especificado por dwTransportId não foi habilitado na interface especificada.
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