Función QueryRecoveryAgentsOnEncryptedFile (winefs.h)
Recupera una lista de agentes de recuperación para el archivo especificado.
Sintaxis
DWORD QueryRecoveryAgentsOnEncryptedFile(
[in] LPCWSTR lpFileName,
[out] PENCRYPTION_CERTIFICATE_HASH_LIST *pRecoveryAgents
);
Parámetros
[in] lpFileName
Nombre del archivo.
[out] pRecoveryAgents
Puntero a una estructura de ENCRYPTION_CERTIFICATE_HASH_LIST que recibe una lista de agentes de recuperación.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista completa de los códigos de error, consulta Códigos de error del sistema o el archivo de encabezado WinError.h.
Comentarios
Cuando ya no se necesite la lista de agentes de recuperación, puede liberarla llamando a la función FreeEncryptionCertificateHashList .
En Windows 8, Windows Server 2012 y versiones posteriores, esta función es compatible con las siguientes tecnologías.
| Tecnología | Compatible |
|---|---|
| Protocolo Bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | No |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | No |
| Sistema de archivos de Volumen compartido de clúster (CsvFS) | No |
| Sistema de archivos resistente a errores (ReFS) | No |
SMB 3.0 no admite EFS en recursos compartidos con capacidad de disponibilidad continua.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winefs.h (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |
| Conjunto de API | ext-ms-win-advapi32-encryptedfile-l1-1-1 (introducido en Windows 10, versión 10.0.14393) |
Consulte también
ENCRYPTION_CERTIFICATE_HASH_LIST