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

Статья
06/13/2023

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

Примечание

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

Синтаксис

uint32 UnlockWithCertificateFile(
  [in] string FileName,
  [in] string PIN
);

Параметры

FileName [in]

Тип: строка

Строка, указывающая расположение и имя CER-файла, используемого для получения отпечатка сертификата. Сертификат шифрования должен быть экспортирован в формате CER (Distinguished Encoding Rules(DER) в двоичном формате X.509 или X.509 в кодировке Base-64). Сертификат шифрования может быть создан из PKI Майкрософт, стороннего PKI или самозаверяющего сертификата.

ПИН-код [in]

Тип: строка

Указанная пользователем личная идентификационная строка. Эта строка должна состоять из последовательности из 4–20 цифр. Эта строка используется для автоматической проверки подлинности поставщика хранилища ключей (KSP) при использовании с интеллектуальным карта.

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

Тип: uint32

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

Возвращаемый код или значение	Описание
S_OK 0 (0x0)	Метод выполнен успешно.
ERROR_FILE_NOT_FOUND 0000000002 (0x2)	Система не может создать указанный файл.
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

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