Partager via


Fonction QueryRecoveryAgentsOnEncryptedFile (winefs.h)

Récupère une liste d’agents de récupération pour le fichier spécifié.

Syntaxe

DWORD QueryRecoveryAgentsOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pRecoveryAgents
);

Paramètres

[in] lpFileName

Nom du fichier.

[out] pRecoveryAgents

Pointeur vers une structure de ENCRYPTION_CERTIFICATE_HASH_LIST qui reçoit une liste d’agents de récupération.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système ou le fichier d’en-tête WinError.h.

Remarques

Lorsque la liste des agents de récupération n’est plus nécessaire, libérez-la en appelant la fonction FreeEncryptionCertificateHashList .

Dans Windows 8, Windows Server 2012 et versions ultérieures, cette fonction est prise en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 Oui
Basculement transparent SMB 3.0 (TFO) No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) No
Système de fichiers du volume partagé de cluster (CsvFS) No
Système de fichiers résilient (ReFS) No
 

SMB 3.0 ne prend pas en charge EFS sur les partages avec une fonctionnalité de disponibilité continue.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winefs.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll
Ensemble d’API ext-ms-win-advapi32-encryptedfile-l1-1-1 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

ENCRYPTION_CERTIFICATE_HASH_LIST

Chiffrement de fichiers

Fonctions de gestion des fichiers

FreeEncryptionCertificateHashList