Función CredUnprotectA (wincred.h)

La función CredUnprotect descifra las credenciales que se cifraron anteriormente mediante la función CredProtect . 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. Establezca 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 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 pszCredentials . En la salida, si 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 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 o valor devuelto	Descripción
ERROR_NOT_CAPABLE	El contexto de seguridad usado para cifrar las credenciales es diferente del contexto de seguridad utilizado para descifrar las credenciales.
ERROR_INSUFFICIENT_BUFFER	El búfer pszCredentials era de tamaño insuficiente.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincred.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll