Función QueryRecoveryAgentsOnEncryptedFile (winefs.h)

  • Artículo

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

Cifrado de archivos

Funciones de administración de archivos

FreeEncryptionCertificateHashList