Compartilhar via


Função MprConfigTransportGetHandle (mprapi.h)

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