Função MprConfigTransportGetHandle (mprapi.h)

Artigo
08/24/2023

A função MprConfigTransportGetHandle recupera um identificador para a configuração do protocolo de transporte especificado na configuração do roteador especificada.

Sintaxe

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

Parâmetros

[in] hMprConfig

Manipule para a configuração do roteador. O identificador é obtido de uma chamada anterior para MprConfigServerConnect.

[in] dwTransportId

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

Valor	Transporte (Família de Protocolos)
PID_ATALK	Appletalk
PID_IP	Protocolo de 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] phRouterTransport

Um ponteiro para um
Variável HANDLE que recebe o tipo de identificador de configuração de transporte indicado 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 seguintes códigos de erro.

Valor	Significado
ERROR_INVALID_PARAMETER	O parâmetro hMprConfig e/ou o parâmetro phRouterTransport é NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_UNKNOWN_PROTOCOL_ID	O protocolo de transporte especificado por dwTransportId não foi encontrado 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