Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
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. |
|
Já existe uma interface com o mesmo nome. |
|
Recursos insuficientes para concluir a operação. |
|
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 |