Función MprAdminServerGetCredentials (mprapi.h)

La función MprAdminServerGetCredentials recupera la clave precompartida para el servidor especificado.

Sintaxis

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

Parámetros

[in] hMprServer

Identificador de un servidor Windows. Obtenga este identificador llamando a MprAdminMIBServerConnect.

[in] dwLevel

Valor DWORD que describe el formato en el que se devuelve la información en el parámetro lplpbBuffer . Debe ser cero.

[out] lplpbBuffer

Al finalizar correctamente, un puntero a una estructura de MPR_CREDENTIALSEX_1 que contiene la clave previamente compartida para el servidor. Libere la memoria ocupada por esta estructura con MprAdminBufferFree.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor	Significado
ERROR_ACCESS_DENIED	La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_INVALID_PARAMETER	El parámetro lplpbBuffer es NULL.
ERROR_NOT_SUPPORTED	El parámetro dwLevel no es cero.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Comentarios

El servidor mantiene una sola clave precompartida para todos los usuarios.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll

Consulte también

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

Funciones de administración del enrutador

Referencia de administración de enrutadores