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_ACTIVATED
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。

托管对象格式 (MOF) 文件包含 Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Windows SDK 的一部分安装。 使用 服务器管理器 添加关联角色时，这些角色将安装在服务器上。 有关 MOF 文件的详细信息，请参阅 托管对象格式 (MOF) 。

要求

要求 值
最低受支持的客户端
 Windows 7 企业版，Windows 7 旗舰版 [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 R2 [仅限桌面应用]
命名空间
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另请参阅

Win32_EncryptableVolume