Win32_EncryptableVolume クラスの UnlockWithNumericalPassword メソッド
Win32_EncryptableVolume クラスの UnlockWithNumericalPassword メソッドは、指定された数値パスワードを使用してデータ ボリュームの内容にアクセスします。
このメソッドを使用してボリュームのロックを解除するには、ボリュームの暗号化キーは、( ProtectKeyWithNumericalPassword メソッドを使用して) 種類 "数値パスワード" の 1 つ以上のキー 保護機能でセキュリティ保護されている必要があります。
Note
ディスクがハードウェア暗号化をサポートしている場合、この関数はバンドの状態を "unlocked" に設定します
構文
uint32 UnlockWithNumericalPassword(
[in] string NumericalPassword
);
パラメーター
-
NumericalPassword [in]
-
型: string
数値パスワードを指定する文字列。
数値パスワードには 48 桁の数字を含む必要があります。 これらの数字は 6 桁の 8 つのグループに分割でき、各グループの最後の数字はグループのチェックサム値を示します。 6 桁の各グループは 11 で割り切れる必要があり、65536 未満である必要があります。 6 桁のグループに x1、x2、x3、x4、x5、x6 というラベルが付いた場合、チェックサム x6 桁は –x1+x2–x3+x4–x5 mod 11 として計算されます。
数字のグループは、必要に応じてスペースまたはハイフンで区切ることができます。 したがって、"xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" または "xxxxxx xxxxxx xxx" には、有効な数値パスワードを含めることもできます。
戻り値
型: uint32
このメソッドは、次のいずれかのコードまたは失敗した場合に別のエラー コードを返します。
ボリュームが既にロック解除されていて、他のエラーが発生しない場合、このメソッドは 0 を返します。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。 |
|
ボリュームには、"数値パスワード" 型のキー保護機能がありません。 NumericalPassword パラメーターには有効な形式がありますが、数値パスワードを使用してボリュームのロックを解除することはできません。 |
|
NumericalPassword パラメーターは、ボリュームのロックを解除できません。 "数値パスワード" 型の 1 つ以上のキー保護機能が存在しますが、指定された NumericalPassword パラメーターはボリュームのロックを解除できません。 |
|
NumericalPassword パラメーターに有効な形式がありません。 |
解説
マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Windows SDK の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista Enterprise、Windows Vista Ultimate [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| 名前空間 |
Root\CIMV2\Security\MicrosoftVolumeEncryption |
| MOF |
|
関連項目