Función CredProtectA (wincred.h)

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

Sintaxis

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

Parámetros

[in] fAsSelf

Establézcalo en TRUE para especificar que las credenciales se cifran en el contexto de seguridad del proceso actual. Establézcalo 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 de 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 de pszProtectedCredential s. En la salida, si el pszProtectedCredentials no tiene un tamaño suficiente para recibir las credenciales cifradas, este parámetro especifica el tamaño necesario, en caracteres, del pszProtectedCredentials búfer.

[out] ProtectionType

Puntero a un tipo de enumeración CRED_PROTECTION_TYPE 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 .

Observaciones

Tenga en cuenta que la salida de la función CredProtect de 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 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