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
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
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 |