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

  • Статья

Метод ChangeExternalKey класса Win32_EncryptableVolume изменяет внешний ключ, связанный с зашифрованным томом.

Синтаксис

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

Параметры

VolumeKeyProtectorID [in]

Тип: строка

Уникальный строковый идентификатор, используемый для управления зашифрованным предохранителем ключа тома.

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

Тип: uint8[]

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

NewVolumeKeyProtectorID [out]

Тип: строка

Обновленный уникальный строковый идентификатор, используемый для управления зашифрованным предохранителем ключа тома.

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

Тип: uint32

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

Возвращаемый код или значение Описание
S_OK
0 (0x0)
 Метод выполнен успешно.
E_INVALIDARG
2147942487 (0x80070057)
 Параметр NewExternalKey не является массивом размером 32.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Том заблокирован.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 Средство BitLocker не включено в томе. Добавьте предохранитель ключа, чтобы включить BitLocker.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 На этом компьютере находится загрузочный компакт-диск или DVD-диск. Удалите компакт-диск или DVD-диск и перезагрузите компьютер.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 Предоставленный предохранитель ключа не существует на томе.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 Параметр VolumeKeyProtectorID не ссылается на предохранитель ключа типа "Числовой пароль" или "Внешний ключ". Используйте метод ProtectKeyWithNumericalPassword или ProtectKeyWithExternalKey , чтобы создать предохранитель ключа соответствующего типа.

 

Комментарии

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

Требования

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

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

Win32_EncryptableVolume