DuplicateEncryptionInfoFile-Funktion (winefs.h)
Kopiert die EFS-Metadaten aus einer Datei oder einem Verzeichnis in eine andere.
Syntax
DWORD DuplicateEncryptionInfoFile(
[in] LPCWSTR SrcFileName,
[in] LPCWSTR DstFileName,
[in] DWORD dwCreationDistribution,
[in] DWORD dwAttributes,
[in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
Parameter
[in] SrcFileName
Der Name der Datei oder des Verzeichnisses, aus der die EFS-Metadaten kopiert werden sollen. Diese Quelldatei oder dieses Verzeichnis muss verschlüsselt werden.
[in] DstFileName
Der Name der Datei oder des Verzeichnisses, in die die EFS-Metadaten kopiert werden sollen.
Diese Zieldatei oder dieses Verzeichnis muss vor dem Aufruf dieser Funktion nicht verschlüsselt werden. Wenn diese Funktion jedoch erfolgreich abgeschlossen wird, wird sie verschlüsselt.
Wenn der Wert von SrcFileName eine Datei angibt, muss der Wert dieses Parameters auch eine Datei und ebenfalls für Verzeichnisse angeben. Wenn eine Datei oder ein Verzeichnis mit dem durch diesen Parameter angegebenen Namen nicht vorhanden ist, wird eine Datei oder ein Verzeichnis erstellt (je nachdem, ob SrcFileName eine Datei oder ein Verzeichnis angibt).
[in] dwCreationDistribution
Beschreibt, wie die Durch den DstFileName Parameterwert identifizierte Zieldatei oder das Verzeichnis geöffnet werden soll. Im Folgenden sind die gültigen Werte dieses Parameters aufgeführt.
[in] dwAttributes
Die Dateiattribute der Zieldatei oder des Zielverzeichnisses. Das attribut FILE_READ_ONLY wird derzeit von dieser Funktion nicht verarbeitet.
[in, optional] lpSecurityAttributes
Ein Zeiger auf eine SECURITY_ATTRIBUTES Struktur, die die Sicherheitsattribute der Zieldatei oder des Zielverzeichnisses angibt, sofern sie noch nicht vorhanden ist. Wenn Sie NULL-angeben, ruft die Datei oder das Verzeichnis einen Standardsicherheitsdeskriptor ab. Die ACLs im Standardsicherheitsdeskriptor für eine Datei oder ein Verzeichnis werden vom übergeordneten Verzeichnis geerbt.
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 der Headerdatei WinError.h.
Bemerkungen
Der exklusive Zugriff auf die Zieldatei oder das Zielverzeichnis ist von EFS für den Aufruf dieser Funktion erforderlich. Wenn dieser Zugriff nicht bereitgestellt wird, schlägt diese Funktion fehl.
Der Aufrufer sollte über den EFS-Schlüssel für die Quelldatei oder das Quellverzeichnis verfügen, und mindestens die READ_ATTRIBUTE ACL für die Quelldatei oder das Verzeichnis.
Die angegebene Quell- und Zieldatei oder Verzeichnisse sollten sich auf demselben Computer befinden; andernfalls wird ein Fehler zurückgegeben.
In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Abgestützt |
|---|---|
| Server Message Block (SMB) 3.0-Protokoll | Ja |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | Nein |
| Freigegebenes Clustervolumedateisystem (CsvFS) | Nein |
| Resilient File System (ReFS) | Nein |
SMB 3.0 unterstützt EFS für Freigaben mit fortlaufender Verfügbarkeitsfunktion nicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winefs.h (enthalten Windows.h) |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |