次の方法で共有

Win32_EncryptableVolume クラスの ChangeExternalKey メソッド

  • [アーティクル]

Win32_EncryptableVolume クラスの ChangeExternalKey メソッドは、暗号化されたボリュームに関連付けられている外部キーを変更します。

構文

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

パラメーター

VolumeKeyProtectorID [in]

型: string

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

NewExternalKey [in, optional]

型: uint8[]

ボリュームのロック解除に使用される 256 ビット外部キーを指定するバイト配列。

NewVolumeKeyProtectorID [out]

型: string

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

戻り値

型: uint32

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

リターン コード/値 説明
S_OK
0 (0x0)
 メソッドは正常に実行されました。
E_INVALIDARG
2147942487 (0x80070057)
 NewExternalKey パラメーターは、サイズ 32 の配列ではありません。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 ボリュームがロックされています。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 起動可能な CD/DVD がこのコンピューターにあります。 CD/DVD を削除し、コンピューターを再起動します。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 指定されたキー保護機能がボリュームに存在しません。
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 VolumeKeyProtectorID パラメーターは、型 "数値パスワード" または "外部キー" のキー保護機能を参照しません。 ProtectKeyWithNumericalPassword メソッドまたは ProtectKeyWithExternalKey メソッドを使用して、適切な型のキー保護機能を作成します。

 

解説

このメソッドを使用すると、外部キーを使用するキー保護機能の外部キーを変更できます。

必要条件

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

関連項目

Win32_EncryptableVolume