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

  • Статья

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

Синтаксис

uint32 ProtectKeyWithPassphrase(
  [in, optional] string FriendlyName,
  [in]           string Passphrase,
  [out]          string VolumeKeyProtectorID
);

Параметры

FriendlyName [in, необязательный]

Тип: string

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

Парольная фраза [in]

Тип: string

Строка, указывающая парольную фразу.

VolumeKeyProtectorID [out]

Тип: string

Строка, однозначно идентифицирующая созданный предохранитель ключа.

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

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

Тип: uint32

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

Возвращаемый код/значение Описание
S_OK
0 (0x0)
 Метод выполнен успешно.
FVE_E_NOT_ALLOWED_IN_SAFE_MODE
2150694976 (0x80310040)
 Шифрование диска BitLocker можно использовать только для восстановления в безопасном режиме.
FVE_E_POLICY_PASSPHRASE_NOT_ALLOWED
2150695018 (0x8031006A)
 Групповая политика не разрешает создание парольной фразы.
FVE_E_FIPS_PREVENTS_PASSPHRASE
2150695020 (0x8031006C)
 Параметр групповой политики, требующий соответствия FIPS, не позволял создавать или использовать парольную фразу.
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
 Указанная парольная фраза не соответствует требованиям к минимальной или максимальной длине.
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
 Парольная фраза не соответствует требованиям к сложности, заданным администратором в групповой политике.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Том уже заблокирован шифрованием диска BitLocker. Диск необходимо разблокировать из панель управления.
FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)
 Блок управления для зашифрованного тома был обновлен другим потоком.
FVE_E_KEY_PROTECTOR_NOT_SUPPORTED
2150695017 (0x80310069)
 Защита ключа не поддерживается версией шифрования диска BitLocker, в настоящее время на томе.
FVE_E_OS_VOLUME_PASSPHRASE_NOT_ALLOWED
2150695021 (0x8031006D)
 Парольную фразу нельзя добавить в том операционной системы.
FVE_E_PROTECTOR_EXISTS
2150694960 (0x80310030)
 Предоставленный предохранитель ключа уже существует на этом томе.

 

Требования

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

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

Win32_EncryptableVolume