Função MprConfigInterfaceSetInfo (mprapi.h)

Artigo
02/29/2024

A função MprConfigInterfaceSetInfo define a configuração da interface especificada.

Sintaxe

DWORD MprConfigInterfaceSetInfo(
  [in] HANDLE hMprConfig,
  [in] HANDLE hRouterInterface,
  [in] DWORD  dwLevel,
  [in] LPBYTE lpbBuffer
);

Parâmetros

[in] hMprConfig

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

[in] hRouterInterface

Manipule para a configuração da interface que está sendo atualizada. Obtenha esse identificador chamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle ou MprConfigInterfaceEnum.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são estruturadas no parâmetro lpBuffer . Os valores aceitáveis para dwLevel incluem 0, 1, 2 e 3, conforme listado na tabela a seguir.

Valor	Formato de estrutura
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 ou posterior: MPR_INTERFACE_3

[in] lpbBuffer

Um ponteiro para um
MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 ou estrutura MPR_INTERFACE_3 . O parâmetro dwLevel indica o tipo de estrutura. As informações nessa estrutura são usadas para atualizar a configuração da interface.

Retornar valor

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	Pelo menos um dos seguintes é verdadeiro: hMprConfig é NULL. hRouterInterface é NULL. dwLevel não é 0, 1, 2 ou 3. lpBuffer é NULL. Também retornará esse código de erro se a interface for do tipo ROUTER_IF_TYPE_DEDICATED ou ROUTER_IF_TYPE_INTERNAL e a interface estiver habilitada.
ERROR_NO_SUCH_INTERFACE	A interface que corresponde a hRouterInterface não está presente na configuração do roteador.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

A função MprAdminInterfaceSetInfo dá suporte à estrutura MPR_INTERFACE_2 . No entanto, MprConfigInterfaceSetInfo não. Para fazer alterações persistentes em uma interface de discagem de demanda, chame MprAdminInterfaceSetInfo com MPR_INTERFACE_2 e, em seguida, chame MprConfigInterfaceSetInfo com MPR_INTERFACE_0 ou MPR_INTERFACE_1.

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