Compartilhar via

Função MprConfigInterfaceCreate (mprapi.h)

  • Artigo

A função MprConfigInterfaceCreate cria uma interface de roteador na configuração do roteador especificada.

Sintaxe

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Parâmetros

[in] hMprConfig

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

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são estruturadas no parâmetro lpbBuffer . 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.

[out] phRouterInterface

Ponteiro para uma variável de identificador. Essa variável recebe um identificador para a configuração da interface.

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

Valor Significado
ERROR_INVALID_PARAMETER
 Pelo menos um dos seguintes é verdadeiro:
  • hMprConfig é NULL
  • dwLevel não é 0, 1, 2 ou 3.
  • lpbBuffer é NULL
  • phRouterInterface é NULL
ERROR_NOT_ENOUGH_MEMORY
 Recursos insuficientes para concluir a operação.
Outros
 Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

A função MprAdminInterfaceCreate dá suporte à estrutura MPR_INTERFACE_2 . No entanto, MprConfigInterfaceCreate não. Para criar uma interface de discagem de demanda persistente após uma reinicialização, chame MprAdminInterfaceCriar com MPR_INTERFACE_2 e, em seguida, chame MprConfigInterfaceCreate com MPR_INTERFACE_0 ou MPR_INTERFACE_1.

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

Confira também

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

Funções de configuração do roteador

Referência de gerenciamento de roteador