Método UnlockWithCertificateThumbprint da classe Win32_EncryptableVolume

  • Artigo

O método UnlockWithCertificateThumbprint da classe Win32_EncryptableVolume usa a impressão digital do certificado fornecida para obter a chave derivada e desbloquear o volume criptografado.

Observação

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

 

Sintaxe

uint32 UnlockWithCertificateThumbprint(
  [in] string CertThumbprint,
  [in] string PIN
);

Parâmetros

CertThumbprint [in]

Tipo: cadeia de caracteres

Um valor de impressão digital de 0 é aceito e resulta em uma pesquisa no repositório local para o certificado apropriado. Se um único certificado BitLocker for encontrado, a pesquisa será bem-sucedida. Se nenhum ou mais de um certificado for encontrado, o método falhará.

PIN [in]

Tipo: cadeia de caracteres

Uma cadeia de caracteres de identificação pessoal especificada pelo usuário. Essa cadeia de caracteres deve consistir em uma sequência de 4 a 20 dígitos. Essa cadeia de caracteres é usada para autenticar silenciosamente o KSP (provedor de armazenamento de chaves) quando usado com um cartão inteligente.

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_ACTIVATED
2150694920 (0x80310008)
 O BitLocker não está habilitado no volume. Adicione um protetor de chave para habilitar o BitLocker.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
 O volume não pode ser desbloqueado usando as informações fornecidas.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 O protetor de chave fornecido não existe no volume. Você deve inserir outro protetor de chave.
FVE_E_PRIVATEKEY_AUTH_FAILED
2150695060 (0x80310094)
 A chave privada associada ao certificado especificado não pôde ser autorizada. A autorização de chave privada não foi fornecida ou a autorização fornecida não era válida.

 

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