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

Статья
06/13/2023

Метод UnlockWithExternalKey класса Win32_EncryptableVolume использует предоставленный внешний ключ для доступа к содержимому тома данных.

Ключ шифрования тома должен быть защищен с помощью одного или нескольких предохранителей ключа типа "Внешний ключ" с помощью метода ProtectKeyWithExternalKey , чтобы иметь возможность разблокировать том с помощью этого метода.

Примечание

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

Синтаксис

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

Параметры

ExternalKey [in]

Тип: uint8[]

Массив байтов, указывающий 256-разрядный внешний ключ, используемый для разблокировки тома. Этот ключ можно получить, вызвав метод GetExternalKeyFromFile .

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

Тип: uint32

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

Если том уже разблокирован, этот метод возвращает значение 0.

Возвращаемый код/значение	Описание
S_OK 0 (0x0)	Метод выполнен успешно.
ERROR_NOT_FOUND Значение не задано (0x)	В томе отсутствует предохранитель ключа типа "Внешний ключ".
ERROR_INVALID_PASSWORD Значение не задано (0x)	Существует один или несколько предохранителей ключа типа "Внешний ключ", но указанный параметр ExternalKey не может разблокировать том.
E_INVALIDARG 2147942487 (0x80070057)	Параметр ExternalKey не является массивом размера 4.
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	Средство BitLocker не включено в томе. Добавьте предохранитель ключа, чтобы включить BitLocker.

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

Требования

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

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

Win32_EncryptableVolume

Share via