Método UnlockWithCertificateFile da classe Win32_EncryptableVolume

Artigo
06/13/2023

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

Compartilhar via