Funzione DuplicateEncryptionInfoFile (winefs.h)

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.

[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.

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

Requisiti

Vedi anche

Crittografia file

Funzioni di gestione file

SECURITY_ATTRIBUTES