DuplicateEncryptionInfoFile 関数 (winefs.h)

ファイルまたはディレクトリ間で EFS メタデータをコピーします。

構文

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

パラメーター

[in] SrcFileName

EFS メタデータのコピー元となるファイルまたはディレクトリの名前。 このソース ファイルまたはディレクトリは暗号化する必要があります。

[in] DstFileName

EFS メタデータのコピー先となるファイルまたはディレクトリの名前。

このコピー先のファイルまたはディレクトリは、この関数を呼び出す前に暗号化する必要はありません。ただし、この関数が正常に完了すると、暗号化されます。

srcFileName の値 ファイルを指定する場合は、このパラメーターの値もファイルを指定する必要があります。同様に、ディレクトリについても同様です。 このパラメーターで指定した名前のファイルまたはディレクトリが存在しない場合は、ファイルまたはディレクトリが作成されます (SrcFileName ファイルまたはディレクトリを指定するかどうかによって異なります)。

[in] dwCreationDistribution

DstFileName パラメーター値によって識別される宛先ファイルまたはディレクトリを開く方法について説明します。 このパラメーターの有効な値を次に示します。

価値	意味
CREATE_ALWAYS 2	常に、コピー先のファイルまたはディレクトリを作成します。 このパラメーターで CREATE_NEW 以外に渡された値は、CREATE_ALWAYSとして処理されます。
CREATE_NEW 1	コピー先のファイルまたはディレクトリがまだ存在しない場合にのみ作成します。 存在し、この値が指定されている場合、この関数は失敗します。

[in] dwAttributes

コピー先のファイルまたはディレクトリのファイル属性。 FILE_READ_ONLY 属性は現在、この関数によって処理されていません。

[in, optional] lpSecurityAttributes

宛先ファイルまたはディレクトリのセキュリティ属性を指定する SECURITY_ATTRIBUTES 構造体へのポインター (まだ存在しない場合)。 null指定すると、ファイルまたはディレクトリは既定のセキュリティ記述子を取得します。 ファイルまたはディレクトリの既定のセキュリティ記述子の ACL は、その親ディレクトリから継承されます。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの完全な一覧については、システム エラー コードの またはヘッダー ファイル WinError.h を参照してください。

備考

この関数の呼び出しには、転送先のファイルまたはディレクトリへの排他アクセスが EFS によって必要です。 このアクセスが指定されていない場合、この関数は失敗します。

呼び出し元には、ソース ファイルまたはディレクトリの EFS キーと、少なくともソース ファイルまたはディレクトリの READ_ATTRIBUTE ACL が必要です。

指定したコピー元とコピー先のファイルまたはディレクトリは、同じコンピューター上に存在する必要があります。それ以外の場合は、エラーが返されます。

Windows 8 および Windows Server 2012 では、この関数は次のテクノロジでサポートされています。

テクノロジー	サポート
サーバー メッセージ ブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 透過的フェールオーバー (TFO)	いいえ
SMB 3.0 とスケールアウト ファイル共有 (SO)	いいえ
クラスター共有ボリューム ファイル システム (CsvFS)	いいえ
回復性のあるファイル システム (ReFS)	いいえ

 

SMB 3.0 では、継続的な可用性機能を備えた共有での EFS はサポートされていません。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winefs.h (Windows.h を含む)
ライブラリ	Advapi32.lib
DLL	Advapi32.dll

関連項目

ファイル暗号化

ファイル管理機能の

SECURITY_ATTRIBUTES