Fonction RemoveUsersFromEncryptedFile (winefs.h)

  • Article

Supprime les hachages de certificats spécifiés dans un fichier donné.

Syntaxe

DWORD RemoveUsersFromEncryptedFile(
  [in] LPCWSTR                           lpFileName,
  [in] PENCRYPTION_CERTIFICATE_HASH_LIST pHashes
);

Paramètres

[in] lpFileName

Nom du fichier.

[in] pHashes

Pointeur vers une structure de ENCRYPTION_CERTIFICATE_HASH_LIST qui contient une liste de hachages de certificat à supprimer du fichier.

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

La fonction RemoveUsersFromEncryptedFile supprime les hachages de certificat spécifiés s’ils existent dans le fichier spécifié. Si l’un des hachages de certificat est introuvable dans le fichier spécifié, ils sont ignorés et aucun code d’erreur n’est retourné.

À compter de Windows 8 et Windows Server 2012, 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