Função MprConfigTransportSetInfo (mprapi.h)
A função MprConfigTransportSetInfo altera a configuração do protocolo de transporte especificado na configuração do roteador especificado.
Sintaxe
DWORD MprConfigTransportSetInfo(
[in] HANDLE hMprConfig,
[in] HANDLE hRouterTransport,
[in, optional] LPBYTE pGlobalInfo,
[in, optional] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in, optional] DWORD dwClientInterfaceInfoSize,
[in, optional] LPWSTR lpwsDLLPath
);
Parâmetros
[in] hMprConfig
Manipule para a configuração do roteador. Obtenha esse identificador chamando MprConfigServerConnect.
[in] hRouterTransport
Manipule para a configuração do protocolo de transporte que está sendo atualizada. Obtenha esse identificador chamando MprConfigTransportCreate, MprConfigTransportGetHandle ou MprConfigTransportEnum. Os tipos de protocolo de transporte com suporte são listados em Identificadores de Transporte.
[in, optional] pGlobalInfo
Ponteiro para um cabeçalho de informações que especifica informações globais para o protocolo de 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.
Esse parâmetro é opcional; o aplicativo de chamada pode especificar NULL para esse parâmetro.
[in, optional] dwGlobalInfoSize
Especifica o tamanho, em bytes, dos dados apontados por pGlobalInfo. Se o aplicativo de chamada especificar NULL para pGlobalInfo, o aplicativo de chamada deverá especificar zero para esse parâmetro.
[in, optional] pClientInterfaceInfo
Ponteiro para um cabeçalho de informações que especifica informações de interface padrão para roteadores cliente. As 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 por 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.
Esse parâmetro é opcional; o aplicativo de chamada pode especificar NULL para esse parâmetro.
Retornar valor
Se a função for bem-sucedida, o valor retornado será NO_ERROR. Para obter mais informações, consulte a seção Comentários, mais adiante neste tópico.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro.
| Valor | Significado |
|---|---|
|
O parâmetro hMprConfig é NULL, o parâmetro hRouterTransport é NULL ou ambos são NULL. |
|
A configuração do protocolo de transporte que corresponde a hRouterTransport não foi encontrada na configuração do roteador. |
|
Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado. |
Comentários
Use MprConfigTransportSetInfo para definir as informações globais do transporte, as informações de interface padrão ou o nome da DLL do gerenciador de roteadores para o transporte.
MprConfigTransportSetInfo tenta definir os itens na ordem em que eles aparecem na lista de parâmetros:
- Informações globais.
- Informações de interface padrão para roteadores de cliente.
- Nome da DLL do gerenciador de roteadores.
Se os parâmetros pGlobalInfo, pClientInterfaceInfo e lpwsDLLPath forem nulos, a função não fará nada, retornando um valor de NO_ERROR.
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 |