Win32_EncryptableVolume クラスの SaveExternalKeyToFile メソッド

Win32_EncryptableVolume クラスの SaveExternalKeyToFile メソッドは、指定したボリューム キープロテクタに関連付けられている外部キーを、指定したフォルダー内の非表示の読み取り専用ファイルに書き込みます。

このメソッドは、"外部キー" または "TPM とスタートアップ キー" の種類のキー保護機能にのみ適用されます。

構文

uint32 SaveExternalKeyToFile(
  [in] string VolumeKeyProtectorID,
  [in] string Path
);

パラメーター

VolumeKeyProtectorID [in]

型: string

暗号化されたボリューム キー保護機能を管理するために使用される一意の文字列識別子。

Path [in]

型: string

指定したキー保護機能に関連付けられている外部キーを保存するボリュームまたはフォルダーの場所を含む文字列。 このパスにはファイルの名前は含まれません。これは内部であり、バージョンからバージョンに変更される可能性があります。 GetExternalKeyFileName を使用してファイル名を取得します。

戻り値

型: uint32

このメソッドは、次のいずれかのコードまたは失敗した場合に別のエラー コードを返します。

リターン コード/値 説明
S_OK
0 (0x0)
メソッドは正常に実行されました。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
ボリュームがロックされています。
E_INVALIDARG
2147942487 (0x80070057)
VolumeKeyProtectorID パラメーターは、"外部キー" または "TPM およびスタートアップ キー" の種類のキー保護機能を参照しません。
ERROR_PATH_NOT_FOUND
2147942403 (0x80070003)
Path パラメーターは、有効な場所を参照していません。
ファイル名が Path パラメーターに含まれていないことを確認します。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。

 

解説

マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Windows SDK の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

要件

要件 値
サポートされている最小のクライアント
Windows Vista Enterprise、Windows Vista Ultimate [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 [デスクトップ アプリのみ]
名前空間
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

関連項目

Win32_EncryptableVolume