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

  • Статья

Метод UnlockWithCertificateThumbprint класса Win32_EncryptableVolume использует предоставленный отпечаток сертификата для получения производного ключа и разблокировки зашифрованного тома.

Примечание

Если диск поддерживает аппаратное шифрование, эта функция устанавливает состояние полосы в состояние "разблокировано"

 

Синтаксис

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

Параметры

CertThumbprint [in]

Тип: строка

Принимается значение отпечатка 0, что приводит к поиску соответствующего сертификата в локальном хранилище. Если найден один сертификат BitLocker, поиск выполняется успешно. Если не найдено ни одного сертификата, метод завершается ошибкой.

ПИН-код [in]

Тип: строка

Указанная пользователем личная идентификационная строка. Эта строка должна состоять из последовательности из 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 Корпоративная, Windows 7 Максимальная [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 R2 [только классические приложения]
Пространство имен
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

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

Win32_EncryptableVolume