Funzione DuplicateEncryptionInfoFile (winefs.h)

Articolo
08/27/2023

Copia i metadati EFS da un file o da una directory a un altro.

Sintassi

DWORD DuplicateEncryptionInfoFile(
  [in]           LPCWSTR                     SrcFileName,
  [in]           LPCWSTR                     DstFileName,
  [in]           DWORD                       dwCreationDistribution,
  [in]           DWORD                       dwAttributes,
  [in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Parametri

[in] SrcFileName

Nome del file o della directory da cui copiare i metadati EFS. Questo file di origine o directory deve essere crittografato.

[in] DstFileName

Nome del file o della directory in cui copiare i metadati EFS.

Questo file o directory di destinazione non deve essere crittografato prima della chiamata a questa funzione; tuttavia, se questa funzione viene completata correttamente, verrà crittografata.

Se il valore di SrcFileName specifica un file, il valore di questo parametro deve anche specificare un file e, analogamente, per le directory. Se non esiste un file o una directory con il nome specificato da questo parametro, verrà creato un file o una directory ,a seconda che SrcFileName specifichi un file o una directory.

[in] dwCreationDistribution

Descrive come aprire il file di destinazione o la directory identificata dal valore del parametro DstFileName . Di seguito sono riportati i valori validi di questo parametro.

Valore	Significato
CREATE_ALWAYS 2	Creare sempre il file o la directory di destinazione. Qualsiasi valore passato in questo parametro diverso da CREATE_NEW verrà elaborato come CREATE_ALWAYS.
CREATE_NEW 1	Creare il file di destinazione o la directory solo se non esiste già. Se esiste e questo valore viene specificato, questa funzione avrà esito negativo.

[in] dwAttributes

Attributi di file del file di destinazione o della directory. L'attributo FILE_READ_ONLY attualmente non viene elaborato da questa funzione.

[in, optional] lpSecurityAttributes

Puntatore a una struttura SECURITY_ATTRIBUTES che specifica gli attributi di sicurezza del file o della directory di destinazione, se non esiste già. Se si specifica NULL, il file o la directory ottiene un descrittore di sicurezza predefinito. Gli ACL nel descrittore di sicurezza predefinito per un file o una directory vengono ereditati dalla directory padre.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco completo dei codici di errore, vedere Codici errore di sistema o il file di intestazione WinError.h.

Commenti

L'accesso esclusivo al file di destinazione o alla directory è richiesto da EFS per la chiamata a questa funzione. Se l'accesso non viene fornito, questa funzione avrà esito negativo.

Il chiamante deve avere la chiave EFS per il file di origine o la directory e almeno il READ_ATTRIBUTE ACL per il file di origine o la directory.

Il file di origine e di destinazione specificato deve risiedere nello stesso computer; in caso contrario, verrà restituito un errore.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
File system del volume condiviso del cluster (CsvFS)	No
File system resiliente (ReFS)	No

SMB 3.0 non supporta EFS nelle condivisioni con funzionalità di disponibilità continua.

Requisiti


Client minimo supportato	Windows XP Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winefs.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll

Vedi anche

Crittografia file

Funzioni di gestione file

SECURITY_ATTRIBUTES

Condividi tramite