Função MprConfigInterfaceTransportSetInfo (mprapi.h)

Artigo
03/15/2023

A função MprConfigInterfaceTransportSetInfo atualiza as informações de configuração do cliente na interface especificada e no protocolo de transporte.

Sintaxe

DWORD MprConfigInterfaceTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           HANDLE hRouterIfTransport,
  [in, optional] LPBYTE pInterfaceInfo,
  [in, optional] DWORD  dwInterfaceInfoSize
);

Parâmetros

[in] hMprConfig

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

[in] hRouterInterface

Manipule para a configuração de interface na qual atualizar as informações. Obtenha esse identificador chamando MprConfigInterfaceCreate ou MprConfigInterfaceEnum.

[in] hRouterIfTransport

Manipule para a configuração de transporte na qual atualizar as informações para o cliente. Obtenha esse identificador chamando MprConfigInterfaceTransportAdd, MprConfigInterfaceTransportGetHandle ou MprConfigInterfaceTransportEnum. Os tipos de protocolo de transporte com suporte são listados em Identificadores de Transporte.

[in, optional] pInterfaceInfo

Ponteiro para um cabeçalho de informações que contém informações de configuração para o cliente na interface e 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.

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não atualizará as informações de configuração do cliente.

[in, optional] dwInterfaceInfoSize

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

Esse parâmetro é opcional; o aplicativo de chamada pode especificar zero para esse parâmetro. No entanto, se pInterfaceInfo não for NULL, esse parâmetro não poderá ser zero. Para obter mais informações, consulte a seção Comentários, mais adiante neste tópico.

Valor retornado

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
ERROR_INVALID_PARAMETER	Pelo menos um dos seguintes é verdadeiro: hMprConfig é NULL. hRouterInterface é NULL. hRouterIfTransport é NULL.
ERROR_NO_SUCH_INTERFACE	A interface especificada por hRouterInterface não está mais presente na configuração do roteador ou o transporte especificado por hRouterInterface não está mais presente na interface.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

Se o parâmetro pInterfaceInfo for NULL, MprConfigInterfaceTransportSetInfo não fará nada e retornará imediatamente com um valor de NO_ERROR.

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