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.
| 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 |
[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.
| Valor | Significado |
|---|---|
|
O parâmetro hMprConfig é NULL ou o parâmetro phRouterTransport é NULL ou ambos são NULL. |
|
Recursos insuficientes para concluir a operação. |
|
Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado. |
Comentários
Se o transporte especificado já existir, MprConfigTransportCreate fará o equivalente a uma chamada MprConfigTransportSetInfo usando os valores de parâmetro fornecidos.
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 |