Função MprAdminInterfaceCreate (mprapi.h)

Artigo
08/24/2023

A função MprAdminInterfaceCreate cria uma interface em um servidor especificado.

Sintaxe

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

Parâmetros

[in] hMprServer

Manipule para o roteador no qual executar essa chamada. Obtenha esse identificador chamando MprAdminServerConnect.

[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.

[out] phInterface

Ponteiro para uma variável HANDLE . A variável recebe um identificador a ser usado em todas as chamadas subsequentes para gerenciar essa 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 seguintes códigos de erro.

Valor	Significado
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_DDM_NOT_RUNNING	Não há suporte para o tipo de interface do roteador porque o Gerenciador de Interface Dinâmica está configurado para ser executado somente em uma LAN.
ERROR_INTERFACE_ALREADY_EXISTS	Já existe uma interface com o mesmo nome.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_NOT_SUPPORTED	O valor dwLevel é inválido.

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 MprAdminInterfaceCreate com MPR_INTERFACE_2 e 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