Compartilhar via

Método UnlockWithCertificateFile da classe Win32_EncryptableVolume

  • Artigo

O método UnlockWithCertificateFile da classe Win32_EncryptableVolume usa o arquivo de certificado fornecido 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 UnlockWithCertificateFile(
  [in] string FileName,
  [in] string PIN
);

Parâmetros

FileName [in]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que especifica o local e o nome do arquivo .cer usado para recuperar a impressão digital do certificado. Um certificado de criptografia deve ser exportado no formato .cer (Distinguished Encoding Rules (DER) codificado como X.509 binário ou X.509 codificado em Base 64. O certificado de criptografia pode ser gerado do Microsoft PKI, PKI de terceiros ou autoassinado.

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 usada 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.

Código/valor de retorno Descrição
S_OK
0 (0x0)
 O método foi bem-sucedido.
ERROR_FILE_NOT_FOUND
0000000002 (0x2)
 O sistema não pode arquivar o arquivo especificado.
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 com 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 era invá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