Funzione DuplicateEncryptionInfoFile (winefs.h)

Articolo
11/20/2024

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

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 o directory di origine 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 specificare anche 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 nomeFileSrc specifica un file o una directory).

[in] dwCreationDistribution

Viene descritto come aprire il file o la directory di destinazione identificati 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 o la directory di destinazione solo se non esiste già. Se esiste e questo valore viene specificato, questa funzione avrà esito negativo.

[in] dwAttributes

Attributi di file del file o della directory di destinazione. L'attributo FILE_READ_ONLY non è attualmente 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 di errore di sistema o il file di intestazione WinError.h.

Osservazioni

L'accesso esclusivo al file o alla directory di destinazione è 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 o la directory di origine e almeno il READ_ATTRIBUTE ACL per il file o la directory di origine.

Il file o le directory di origine e di destinazione specificati devono trovarsi nello stesso computer; in caso contrario, verrà restituito un errore.

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

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	Sì
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
Cluster Shared Volume File System (CsvFS)	No
Resilient File System (ReFS)	No

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP Professional [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winefs.h (include Windows.h)
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

di crittografia file

funzioni di gestione file

SECURITY_ATTRIBUTES

Condividi tramite