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

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

  • Статья

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