Compartilhar via

Método ProtectKeyWithPassphrase da classe Win32_EncryptableVolume

  • Artigo

O método ProtectKeyWithPassphrase da classe Win32_EncryptableVolume usa a frase secreta para obter a chave derivada. Depois que a chave derivada é calculada, a chave derivada é usada para proteger a chave master do volume criptografado.

Sintaxe

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

Parâmetros

FriendlyName [in, opcional]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que especifica um identificador de cadeia de caracteres atribuído pelo usuário para esse protetor de chave. Se esse parâmetro não for especificado, um valor em branco será usado.

Frase secreta [in]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que especifica a frase secreta.

VolumeKeyProtectorID [out]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que identifica exclusivamente o protetor de chave criado.

Se a unidade der suporte à criptografia de hardware e o BitLocker não tiver tomado a propriedade da banda, a cadeia de caracteres de ID será definida como "BitLocker" e o protetor de chave será gravado por metadados de banda.

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.
FVE_E_NOT_ALLOWED_IN_SAFE_MODE
2150694976 (0x80310040)
 A Criptografia de Unidade do BitLocker só pode ser usada para fins de recuperação quando usada no Modo de Segurança.
FVE_E_POLICY_PASSPHRASE_NOT_ALLOWED
2150695018 (0x8031006A)
 A política de grupo não permite a criação de uma frase secreta.
FVE_E_FIPS_PREVENTS_PASSPHRASE
2150695020 (0x8031006C)
 A configuração de política de grupo que exige a conformidade do FIPS impediu que a frase secreta fosse gerada ou usada.
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
 A frase secreta fornecida não atende aos requisitos de comprimento mínimo ou máximo.
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
 A frase secreta não atende aos requisitos de complexidade definidos pelo administrador na política de grupo.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 O volume já está bloqueado pelo BitLocker Drive Encryption. Você deve desbloquear a unidade de Painel de Controle.
FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)
 O bloco de controle do volume criptografado foi atualizado por outro thread.
FVE_E_KEY_PROTECTOR_NOT_SUPPORTED
2150695017 (0x80310069)
 O protetor de chave não é compatível com a versão do BitLocker Drive Encryption atualmente no volume.
FVE_E_OS_VOLUME_PASSPHRASE_NOT_ALLOWED
2150695021 (0x8031006D)
 A frase secreta não pode ser adicionada ao volume do sistema operacional.
FVE_E_PROTECTOR_EXISTS
2150694960 (0x80310030)
 O protetor de chave fornecido já existe nesse volume.

 

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