Método UnlockWithExternalKey da classe Win32_EncryptableVolume

  • Artigo

O método UnlockWithExternalKey da classe Win32_EncryptableVolume usa uma chave externa fornecida para acessar o conteúdo de um volume de dados.

A chave de criptografia do volume deve ter sido protegida com um ou mais protetores de chave do tipo "Chave Externa" usando o método ProtectKeyWithExternalKey para poder desbloquear o volume com esse método.

Observação

Se o disco der suporte à criptografia de hardware, essa função definirá a banda status como "desbloqueada""

 

Sintaxe

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

Parâmetros

ExternalKey [in]

Tipo: uint8[]

Uma matriz de bytes que especifica a chave externa de 256 bits usada para desbloquear o volume. Essa chave pode ser obtida chamando o método GetExternalKeyFromFile .

Valor retornado

Tipo: uint32

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

Se o volume já estiver desbloqueado, esse método retornará 0.

Retornar código/valor Descrição
S_OK
0 (0x0)
 O método foi bem-sucedido.
ERROR_NOT_FOUND
Nenhum valor fornecido (0x)
 O volume não tem um protetor de chave do tipo "Chave Externa".
ERROR_INVALID_PASSWORD
Nenhum valor fornecido (0x)
 Existem um ou mais protetores de chave do tipo "Chave Externa", mas o parâmetro ExternalKey especificado não pode desbloquear o volume.
E_INVALIDARG
2147942487 (0x80070057)
 O parâmetro ExternalKey não é uma matriz de tamanho 4.
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