RemoveUsersFromEncryptedFile-Funktion (winefs.h)

Entfernt angegebene Zertifikathashes aus einer angegebenen Datei.

Syntax

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

Parameter

[in] lpFileName

Der Name der Datei.

[in] pHashes

Ein Zeiger auf eine ENCRYPTION_CERTIFICATE_HASH_LIST-Struktur , die eine Liste von Zertifikathashes enthält, die aus der Datei entfernt werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes oder in der Headerdatei WinError.h.

Hinweise

Die RemoveUsersFromEncryptedFile-Funktion entfernt die angegebenen Zertifikathashes, wenn sie in der angegebenen Datei vorhanden sind. Wenn einer der Zertifikathashes in der angegebenen Datei nicht gefunden wird, werden sie ignoriert, und es wird kein Fehlercode zurückgegeben.

Ab Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	No
Robustes Dateisystem (Resilient File System, ReFS)	No

 

SMB 3.0 unterstützt EFS für Freigaben mit Continuous Availability-Funktion nicht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winefs.h (einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll
APIs	ext-ms-win-advapi32-encryptedfile-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

ENCRYPTION_CERTIFICATE_HASH_LIST

Dateiverschlüsselung

Dateiverwaltungsfunktionen