Função MprAdminServerGetInfo (mprapi.h)

Artigo
08/24/2023

A função MprAdminServerGetInfo recupera informações sobre o servidor RRAS especificado.

Sintaxe

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parâmetros

[in] hMprServer

Manipule para o roteador a ser consultado. Obtenha esse identificador chamando MprAdminServerConnect.

[in] dwLevel

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

Valor	Formato de estrutura
0	Windows 2000 Server ou posterior: MPR_SERVER_0
1	Windows Server 2003 ou posterior: MPR_SERVER_1
2	Windows Server 2008 ou posterior: MPR_SERVER_2

[out] lplpbBuffer

Após a conclusão bem-sucedida, um ponteiro para um MPR_SERVER_0, MPR_SERVER_1,
ou MPR_SERVER_2 estrutura. O parâmetro dwLevel indica o tipo de estrutura. Liberar a memória para esse buffer usando MprAdminBufferFree

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

Valor	Significado
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_INVALID_PARAMETER	O parâmetro lplpbBuffer é NULL.
RPC_S_INVALID_BINDING	O parâmetro hMprServer é NULL.

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