Función CredProtectW (wincred.h)

La función CredProtect cifra las credenciales especificadas para que solo el contexto de seguridad actual pueda descifrarlas.

Sintaxis

BOOL CredProtectW(
  [in]      BOOL                 fAsSelf,
  [in]      LPWSTR               pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPWSTR               pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

Parámetros

[in] fAsSelf

Establezca en TRUE para especificar que las credenciales se cifran en el contexto de seguridad del proceso actual. Se establece en FALSE para especificar que las credenciales se cifran en el contexto de seguridad del contexto de seguridad del subproceso que llama.

[in] pszCredentials

Puntero a una cadena que especifica las credenciales que se van a cifrar. La función cifra el número de caracteres proporcionados en el parámetro cchCredentials .

[in] cchCredentials

Tamaño, en caracteres, del búfer pszCredentials .

[out] pszProtectedCredentials

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

[in, out] pcchMaxChars

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

[out] ProtectionType

Puntero a un CRED_PROTECTION_TYPE tipo de enumeración que, en la salida, especifica el tipo de protección proporcionado.

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 .

Comentarios

Tenga en cuenta que la salida de la función CredProtect no está protegida por la integridad, por lo que si se modifica la salida, la función CredUnprotect no se actualiza y puede producir resultados incorrectos.

Nota

El encabezado wincred.h define CredProtect 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