Função MprConfigInterfaceTransportAdd (mprapi.h)

Artigo
08/24/2023

A função MprConfigInterfaceTransportAdd adiciona um protocolo de transporte a uma configuração de interface no roteador.

Sintaxe

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

Parâmetros

[in] hMprConfig

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

[in] hRouterInterface

Identificador para a configuração da interface à qual o transporte especificado é adicionado. Obtenha esse identificador chamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle ou MprConfigInterfaceEnum.

[in] dwTransportId

Um valor DWORD que descreve o transporte a ser adicionado à configuração. Esse parâmetro também identifica o gerenciador de roteador para o transporte. 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

[in, optional] lpwsTransportName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do transporte que está sendo adicionado. Se esse parâmetro não for especificado e o transporte for IP ou IPX, MprConfigInterfaceTransportAdd usará IP ou IPX. Se esse parâmetro não for especificado e o transporte for diferente de IP ou IPX, MprConfigInterfaceTransportAdd converterá o parâmetro dwTransportId em uma cadeia de caracteres e o usará como o nome do transporte.

[in] pInterfaceInfo

Ponteiro para um cabeçalho de informações que contém informações para a interface e o transporte especificados. O gerenciador de roteadores para o transporte especificado interpreta essas informações. Use as Funções de Cabeçalho de Informações para manipular cabeçalhos de informações.

[in] dwInterfaceInfoSize

Especifica o tamanho, em bytes, dos dados apontados por pInterfaceInfo.

[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 .

Valor retornado

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	Uma das seguintes condições é verdadeira: hMprConfig é NULL. hRouterInterface é NULL. phRouterIfTransport é NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

Além de especificar um transporte, o parâmetro dwTransportId também especifica um gerenciador de roteador, pois um roteador mantém um gerenciador de roteador exclusivo para cada transporte.

Se o transporte especificado já existir, MprConfigInterfaceTransportAdd fará o equivalente a uma chamada MprConfigInterfaceTransportSetInfo usando os valores de parâmetro especificados.

Requisitos


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