QueryUsersOnEncryptedFile-Funktion (winefs.h)
Ruft eine Liste von Benutzer*innen für die angegebene Datei ab.
Syntax
DWORD QueryUsersOnEncryptedFile(
[in] LPCWSTR lpFileName,
[out] PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers
);
Parameter
[in] lpFileName
Der Name der Datei.
[out] pUsers
Ein Zeiger auf eine ENCRYPTION_CERTIFICATE_HASH_LIST-Struktur , die die Liste der Benutzer empfängt.
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
Wenn die Liste der Benutzer nicht mehr benötigt wird, rufen Sie die Funktion FreeEncryptionCertificateHashList auf, um die Liste zu befreien.
In Windows 8, Windows Server 2012 und höher 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
| 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ßlich Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |
| APIs | ext-ms-win-advapi32-encryptedfile-l1-1-0 (in Windows 8 eingeführt) |