Compartir a través de


Función MprAdminServerSetCredentials (mprapi.h)

Las funciones MprAdminServerSetCredentials establecen la clave precompartida para el servidor especificado.

Sintaxis

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parámetros

[in] hMprServer

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

[in] dwLevel

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

[in] lpbBuffer

Puntero a una estructura de MPR_CREDENTIALSEX_1 que contiene la clave precompartida para el servidor.

Valor devuelto

Si la función se ejecuta 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 lpbBuffer 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.

Para eliminar la clave precompartida, llame a MprAdminServerSetCredentials con el miembro dwSizeMPR_CREDENTIALSEX_1 establecido en cero.

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

MprAdminServerGetCredentials

Funciones de administración del enrutador

Referencia de administración de enrutadores