Função MprConfigServerGetInfo (mprapi.h)

Artigo
02/29/2024

A função MprConfigServerGetInfo recupera informações de configuração no nível do servidor para o roteador especificado.

Sintaxe

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

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 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. Libere a memória para esse buffer usando MprConfigBufferFree.

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: O parâmetro hMprConfig é NULL. O parâmetro dwLevel não é zero. O parâmetro lplpBuffer é 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.

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