Метод ChangePIN класса Win32_EncryptableVolume

  • Статья

Метод ChangePIN класса Win32_EncryptableVolume изменяет ПИН-код, связанный с зашифрованным томом. Если включена групповая политика "Разрешить расширенные ПИН-коды для запуска", ПИН-код может содержать буквы, символы и пробелы в дополнение к цифрам.

Синтаксис

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

Параметры

VolumeKeyProtectorID [in]

Тип: string

Уникальный строковый идентификатор, используемый для управления зашифрованным предохранителем ключа тома.

NewPIN [in]

Тип: string

Указанная пользователем строка личной идентификации. Эта строка должна состоять из последовательности из 4–20 цифр или, если включена групповая политика "Разрешить расширенные ПИН-коды для запуска", от 4 до 20 букв, символов, пробелов или чисел.

Возвращаемое значение

Тип: uint32

Этот метод возвращает один из следующих кодов или другой код ошибки в случае сбоя.

Возвращаемый код/значение Описание
S_OK
0 (0x0)
 Метод выполнен успешно.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 На этом компьютере есть загрузочный компакт-диск/DVD-диск. Извлеките компакт-диск или DVD-диск и перезагрузите компьютер.
FVE_E_INVALID_PIN_CHARS
2150695066 (0x8031009A)
 Параметр NewPIN содержит недопустимые символы. Если групповая политика "Разрешить расширенные ПИН-коды для запуска" отключен, поддерживаются только номера.
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 создает новый предохранитель доверенного платформенного модуля и ПИН-кода на основе существующих сведений о предохранителе и вновь предоставленного ПИН-кода. Новый предохранитель будет иметь тот же GUID. Метод ChangePIN также можно вызвать для изменения ПИН-кода любого предохранителя ключа, использующего ПИН-код, например TPM и PIN-код или доверенного платформенного модуля с ПИН-кодом и USB.

MOF-файлы содержат определения для классов инструментария управления Windows (WMI). MOF-файлы не устанавливаются в составе пакета Windows SDK. Они устанавливаются на сервере при добавлении связанной роли с помощью диспетчер сервера. Дополнительные сведения о MOF-файлах см. в разделе Формат управляемого объекта (MOF).

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 Корпоративная, Windows 7 Максимальная [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 R2 [только классические приложения]
Пространство имен
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

См. также раздел

Win32_EncryptableVolume