Share via

Win32_EncryptableVolume 類別的 ChangePIN 方法

  • 發行項

Win32_EncryptableVolume類別的ChangePIN方法會變更與加密磁片區相關聯的 PIN。 如果已啟用「允許啟動的增強型 PIN」群組原則，PIN 除了數位之外，還可以包含字母、符號和空格。

語法

uint32 ChangePIN(
  [in] string VolumeKeyProtectorID,
  [in] string NewPIN
);

參數

VolumeKeyProtectorID [in]

類型： 字串

用來管理加密磁片區金鑰保護裝置的唯一字串識別碼。

NewPIN [in]

類型： 字串

使用者指定的個人識別字串。 此字串必須包含 4 到 20 位數的序列，如果已啟用「允許啟動的增強型 PIN」群組原則，則為 4 到 20 個字母、符號、空格或數位。

傳回值

類型： uint32

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

傳回碼/值 描述
S_OK
0 (0x0)
此方法成功。
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
在此電腦中找到可開機的 CD/DVD。 移除 CD/DVD 並重新啟動電腦。
FVE_E_INVALID_PIN_CHARS
2150695066 (0x8031009A)
NewPIN參數包含不正確字元。 停用[允許啟動的增強型 PIN] 群組原則時，僅支援數位。
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
VolumeKeyProtectorID參數不會參考類型為「數值密碼」或「外部金鑰」的金鑰保護裝置。 使用 ProtectKeyWithNumericalPassword 或 ProtectKeyWithExternalKey 方法來建立適當類型的金鑰保護裝置。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
磁片區已鎖定。
FVE_E_NOT_ACTI加值稅ED
2150694920 (0x80310008)
磁碟區上未啟用 BitLocker。 新增金鑰保護裝置以啟用 BitLocker。
FVE_E_POLICY_INVALID_PIN_LENGTH
2150695016 (0x80310068)
提供的NewPIN參數長度超過 20 個字元、短于 4 個字元，或小於群組原則所指定的最小長度。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
提供的金鑰保護裝置不存在於磁片區上。
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
在此電腦上找不到相容的信賴平臺模組 (TPM) 。

 

備註

ChangePIN方法會根據現有的保護裝置資訊和新提供的 PIN，建立新的 TPM 和 PIN 保護裝置。 新的保護裝置會有相同的 GUID。 您也可以呼叫 ChangePIN 方法，以變更任何使用 PIN 的金鑰保護裝置 PIN，例如 TPM 和 PIN 或具有 PIN 和 USB 的 TPM。

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

規格需求

需求 值
最低支援的用戶端
 Windows 7 企業版，Windows 7 旗艦版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 R2 [僅限桌面應用程式]
命名空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另請參閱

Win32_EncryptableVolume