Win32_EncryptableVolume クラスの UnlockWithCertificateThumbprint メソッド

Win32_EncryptableVolume クラスの UnlockWithCertificateThumbprint メソッドは、指定された証明書の拇印を使用して派生キーを取得し、暗号化されたボリュームのロックを解除します。

注意

ディスクがハードウェア暗号化をサポートしている場合、この関数はバンドの状態を "ロック解除" に設定します

構文

uint32 UnlockWithCertificateThumbprint(
  [in] string CertThumbprint,
  [in] string PIN
);

CertThumbprint [in]

型: string

拇印の値 0 が受け入れられ、適切な証明書のローカルストアが検索されます。 1 つの BitLocker 証明書が見つかった場合、検索は成功します。 1 つ以上の証明書が見つからない場合、メソッドは失敗します。

PIN [入力]

型: string

ユーザー指定の個人識別文字列。この文字列は、4 ~ 20 桁のシーケンスで構成されている必要があります。この文字列は、スマートカードで使用する場合に、キーストレージプロバイダー (KSP) をサイレント認証するために使用されます。

型: uint32

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

リターンコード/値	説明
S_OK 0 (0x0)	メソッドは正常に実行されました。
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。
FVE_E_FAILED_AUTHENTICATION 2150694951 (0x80310027)	指定された情報を使用してボリュームのロックを解除することはできません。
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	指定されたキー保護機能がボリュームに存在しません。別のキー保護機能を入力する必要があります。
FVE_E_PRIVATEKEY_AUTH_FAILED 2150695060 (0x80310094)	指定した証明書に関連付けられている秘密キーを承認できませんでした。秘密キーの承認が指定されていないか、指定された承認が無効でした。

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