Compartilhar via

Função MprAdminServerGetCredentials (mprapi.h)

  • Artigo

A função MprAdminServerGetCredentials recupera a chave pré-compartilhada para o servidor especificado.

Sintaxe

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

Parâmetros

[in] hMprServer

Manipule para um servidor Windows. Obtenha esse identificador chamando MprAdminMIBServerConnect.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são retornadas no parâmetro lplpbBuffer . Deve ser zero.

[out] lplpbBuffer

Após a conclusão bem-sucedida, um ponteiro para uma estrutura MPR_CREDENTIALSEX_1 que contém a chave pré-compartilhada para o servidor. Libere a memória ocupada por essa estrutura com 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.
ERROR_NOT_SUPPORTED
 O parâmetro dwLevel não é zero.
Outros
 Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

O servidor mantém uma única chave pré-compartilhada para todos os usuários.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

Funções de administração do roteador

Referência de gerenciamento de roteador