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 Transparent Failover (TFO) No
スケールアウト ファイル共有 (SO) を使う SMB 3.0 No
クラスターの共有ボリューム ファイル システム (CsvFS) No
Resilient File System (ReFS) No
 

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

要件

   
サポートされている最小のクライアント Windows XP Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winefs.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

関連項目

ファイルの暗号化

ファイル管理の関数

SECURITY_ATTRIBUTES