Método ChangeExternalKey da classe Win32_EncryptableVolume

  • Artigo

O método ChangeExternalKey da classe Win32_EncryptableVolume altera uma chave externa associada a um volume criptografado.

Sintaxe

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

Parâmetros

VolumeKeyProtectorID [in]

Tipo: cadeia de caracteres

Um identificador de cadeia de caracteres exclusivo usado para gerenciar um protetor de chave de volume criptografado.

NewExternalKey [in, opcional]

Tipo: uint8[]

Uma matriz de bytes que especifica a chave externa de 256 bits usada para desbloquear o volume.

NewVolumeKeyProtectorID [out]

Tipo: cadeia de caracteres

Um identificador de cadeia de caracteres exclusivo atualizado que é usado para gerenciar um protetor de chave de volume criptografado.

Valor retornado

Tipo: uint32

Esse método retornará um dos códigos a seguir ou outro código de erro se falhar.

Retornar código/valor Descrição
S_OK
0 (0x0)
 O método foi bem-sucedido.
E_INVALIDARG
2147942487 (0x80070057)
 O parâmetro NewExternalKey não é uma matriz de tamanho 32.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 O volume está bloqueado.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 O BitLocker não está habilitado no volume. Adicione um protetor de chave para habilitar o BitLocker.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 Um CD/DVD inicializável é encontrado neste computador. Remova o CD/DVD e reinicie o computador.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 O protetor de chave fornecido não existe no volume.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 O parâmetro VolumeKeyProtectorID não se refere a um protetor de chave do tipo "Senha Numérica" ou "Chave Externa". Use o método ProtectKeyWithNumericalPassword ou ProtectKeyWithExternalKey para criar um protetor de chave do tipo apropriado.

 

Comentários

Esse método pode ser usado para alterar a chave externa para qualquer protetor de chave que use uma chave externa.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 7 Enterprise, Windows 7 Ultimate [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Namespace
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Confira também

Win32_EncryptableVolume