Share via

Win32_EncryptableVolume 類別的 UnlockWithNumericalPassword 方法

  • 發行項

Win32_EncryptableVolume類別的UnlockWithNumericalPassword方法會使用提供的數值密碼來存取資料磁片區的內容。

使用 ProtectKeyWithNumericalPassword 方法來解除鎖定磁片區，必須使用「數值密碼」 類型的一或多個金鑰保護裝置來保護磁片區 (，) 才能使用此方法解除鎖定磁片區。

注意

如果磁片支援硬體加密，此函式會將訊號狀態設定為「解除鎖定」

 

語法

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

參數

NumericalPassword [in]

類型： 字串

指定數值密碼的字串。

數值密碼必須包含 48 位數。 這些數位可以分成 8 組 6 位數，每個群組中的最後一個數位表示群組的總和檢查碼值。 每個 6 位數的群組都必須由 11 區分，且必須小於 65536。 假設有六位數的群組標示為 x1、x2、x3、x4、x5 和 x6，總和檢查碼 x6 數位會計算為 –x1+x2–x3+x4–x5 mod 11。

數位群組可以選擇性地以空格或連字號分隔。 因此，「xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx」 或 「xxxxxx xxxxxx」也可能包含有效的數值密碼。

傳回值

類型： uint32

此方法會在失敗時傳回下列其中一個代碼或另一個錯誤碼。

如果磁片區已經解除鎖定，而且沒有發生其他錯誤，這個方法會傳回 0。

傳回碼/值 描述
S_OK
0 (0x0)
此方法成功。
FVE_E_NOT_ACTI加值稅ED
2150694920 (0x80310008)
磁碟區上未啟用 BitLocker。 新增金鑰保護裝置以啟用 BitLocker。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
磁片區沒有「數值密碼」類型的金鑰保護裝置。
NumericalPassword參數具有有效的格式，但您無法使用數值密碼來解除鎖定磁片區。
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
NumericalPassword參數無法解除鎖定磁片區。
「數值密碼」類型的一或多個金鑰保護裝置存在，但指定的 NumericalPassword 參數無法解除鎖定磁片區。
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
NumericalPassword參數沒有有效的格式。

 

備註

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Windows SDK 的一部分。 當您使用 伺服器管理員 新增相關聯的角色時，它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊，請參閱 Managed Object Format (MOF) 。

規格需求

需求 值
最低支援的用戶端
 Windows Vista Enterprise、Windows Vista Ultimate [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
命名空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另請參閱

Win32_EncryptableVolume