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

Статья
06/13/2023

Метод 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

Поделиться через