Função MprConfigTransportCreate (mprapi.h)

A função MprConfigTransportCreate adiciona o transporte especificado à lista de protocolos de transporte presentes na configuração do roteador especificada.

Sintaxe

DWORD MprConfigTransportCreate(
  [in]           HANDLE hMprConfig,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pGlobalInfo,
  [in]           DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath,
  [out]          HANDLE *phRouterTransport
);

Parâmetros

[in] hMprConfig

Manipule para a configuração do roteador à qual adicionar o transporte. Obtenha esse identificador chamando MprConfigServerConnect.

[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 são listados na tabela a seguir.

[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, o parâmetro dwTransportId será convertido em uma cadeia de caracteres e usado como o nome do transporte.

[in] pGlobalInfo

Ponteiro para um cabeçalho de informações que especifica informações globais para o transporte. O gerenciador de roteadores para o transporte interpreta essas informações. Use as Funções de Cabeçalho de Informações para manipular cabeçalhos de informações.

[in] dwGlobalInfoSize

Especifica o tamanho, em bytes, dos dados apontados pelo parâmetro pGlobalInfo .

[in, optional] pClientInterfaceInfo

Ponteiro para um cabeçalho de informações que especifica informações de interface padrão para roteadores cliente. Essas informações são usadas para configurar interfaces dinâmicas para roteadores cliente para esse transporte. Use as Funções de Cabeçalho de Informações para manipular cabeçalhos de informações.

Esse parâmetro é opcional; o aplicativo de chamada pode especificar NULL para esse parâmetro.

[in, optional] dwClientInterfaceInfoSize

Especifica o tamanho, em bytes, dos dados apontados pelo parâmetro pClientInterfaceInfo . Se o aplicativo de chamada especificar NULL para pClientInterfaceInfo, o aplicativo de chamada deverá especificar zero para esse parâmetro.

[in, optional] lpwsDLLPath

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da DLL do gerenciador de roteador para o transporte especificado. Se esse nome for especificado, a função definirá o caminho de DLL para esse transporte como esse nome.

Esse parâmetro é opcional; o aplicativo de chamada pode especificar NULL para esse parâmetro.

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

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 seguintes códigos de erro.

Comentários

Se o transporte especificado já existir, MprConfigTransportCreate fará o equivalente a uma chamada MprConfigTransportSetInfo usando os valores de parâmetro fornecidos.

Requisitos

Confira também

FormatMessage

MprConfigServerConnect

Funções de configuração do roteador

Referência de gerenciamento de roteador