Método GetKeyProtectorExternalKey da classe Win32_EncryptableVolume

  • Artigo

O método GetKeyProtectorExternalKey da classe Win32_EncryptableVolume recupera a chave externa para um determinado protetor de chave do tipo apropriado.

O identificador do protetor de chave deve se referir a um protetor de chave do tipo "Chave Externa", "TPM e PIN e Chave de Inicialização" ou "TPM e Chave de Inicialização".

Sintaxe

uint32 GetKeyProtectorExternalKey(
  [in]  string VolumeKeyProtectorID,
  [out] uint8  ExternalKey[]
);

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.

ExternalKey [out]

Tipo: uint8[]

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

Valor retornado

Tipo: uint32

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

Código/valor de retorno Descrição
S_OK
0 (0x0)
 O método foi bem-sucedido.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 O volume está bloqueado.
E_INVALIDARG
2147942487 (0x80070057)
 O parâmetro VolumeKeyProtectorID não se refere a um protetor de chave do tipo "Chave Externa", "TPM e PIN e Chave de Inicialização" ou "TPM e Chave de Inicialização".
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 O BitLocker não está habilitado no volume. Adicione um protetor de chave para habilitar o BitLocker.

 

Comentários

Os arquivos MOF (Managed Object Format) contêm as definições para classes WMI (Instrumentação de Gerenciamento do Windows). Os arquivos MOF não são instalados como parte do SDK do Windows. Eles são instalados no servidor quando você adiciona a função associada usando o Gerenciador do Servidor. Para obter mais informações sobre arquivos MOF, consulte MOF (Managed Object Format).

Requisitos

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

Confira também

Win32_EncryptableVolume