Método UnlockWithCertificateThumbprint de la clase Win32_EncryptableVolume

  • Artículo

El método UnlockWithCertificateThumbprint de la clase Win32_EncryptableVolume usa la huella digital del certificado proporcionada para obtener la clave derivada y desbloquear el volumen cifrado.

Nota

Si el disco admite el cifrado de hardware, esta función establece el estado de banda en "desbloqueado"

 

Sintaxis

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

Parámetros

CertThumbprint [in]

Tipo: cadena

Se acepta un valor de huella digital de 0 y da como resultado una búsqueda del almacén local para el certificado adecuado. Si se encuentra un único certificado de BitLocker, la búsqueda se realiza correctamente. Si no se encuentra ninguno o más de un certificado, se produce un error en el método.

PIN [in]

Tipo: cadena

Cadena de identificación personal especificada por el usuario. Esta cadena debe constar de una secuencia de 4 a 20 dígitos. Esta cadena se usa para autenticar de forma silenciosa el proveedor de almacenamiento de claves (KSP) cuando se usa con una tarjeta inteligente.

Valor devuelto

Tipo: uint32

Este método devuelve uno de los códigos siguientes u otro código de error si se produce un error.

Código o valor devuelto Descripción
S_OK
0 (0x0)
 Método realizado correctamente.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker no está habilitado en el volumen. Agregue un protector de clave para habilitar BitLocker.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
 El volumen no se puede desbloquear mediante la información proporcionada.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 El protector de clave proporcionado no existe en el volumen. Debe escribir otro protector de clave.
FVE_E_PRIVATEKEY_AUTH_FAILED
2150695060 (0x80310094)
 No se pudo autorizar la clave privada asociada al certificado especificado. La autorización de clave privada no se proporcionó o la autorización proporcionada no era válida.

 

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 Enterprise, Windows 7 Ultimate [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2008 R2 [solo aplicaciones de escritorio]
Espacio de nombres
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Consulte también

Win32_EncryptableVolume