Función CredUnprotectA (wincred.h)

La función CredUnprotect descifra las credenciales que se cifraron anteriormente mediante la función credProtect de . Las credenciales deben haberse cifrado en el mismo contexto de seguridad en el que se llama a CredUnprotect.

Sintaxis

BOOL CredUnprotectA(
  [in]      BOOL  fAsSelf,
  [in]      LPSTR pszProtectedCredentials,
  [in]      DWORD cchProtectedCredentials,
  [out]     LPSTR pszCredentials,
  [in, out] DWORD *pcchMaxChars
);

Parámetros

[in] fAsSelf

Establézcalo en TRUE para especificar que las credenciales se cifraron en el contexto de seguridad del proceso actual. Establézcalo en FALSE para especificar que las credenciales se cifraron en el contexto de seguridad del contexto de seguridad del subproceso que llama.

[in] pszProtectedCredentials

Puntero a una cadena que especifica las credenciales cifradas.

[in] cchProtectedCredentials

Tamaño, en caracteres, del búfer de pszProtectedCredentials.

[out] pszCredentials

Puntero a una cadena que, en la salida, recibe las credenciales descifradas.

[in, out] pcchMaxChars

Tamaño, en caracteres del búfer de pszCredentials. En la salida, si el pszCredentials no tiene un tamaño suficiente para recibir las credenciales cifradas, este parámetro especifica el tamaño necesario, en caracteres, del búfer de pszCredentials.

Valor devuelto

TRUE si la función se realiza correctamente; De lo contrario, FALSE.

Para obtener información de error extendida, llame a la función getLastError . En la tabla siguiente se muestran valores comunes para la función GetLastError.

Código y valor devueltos	Descripción
ERROR_NOT_CAPABLE	El contexto de seguridad usado para cifrar las credenciales es diferente del contexto de seguridad que se usa para descifrar las credenciales.
ERROR_INSUFFICIENT_BUFFER	El pszCredentials búfer era de tamaño insuficiente.

Observaciones

Nota

El encabezado wincred.h define CredUnprotect como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wincred.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll