Método UnlockWithCertificateFile de la clase Win32_EncryptableVolume

  • Artículo

El método UnlockWithCertificateFile de la clase Win32_EncryptableVolume usa el archivo de certificado proporcionado 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 UnlockWithCertificateFile(
  [in] string FileName,
  [in] string PIN
);

Parámetros

FileName [in]

Tipo: cadena

Cadena que especifica la ubicación y el nombre del archivo .cer que se usa para recuperar la huella digital del certificado. Se debe exportar un certificado de cifrado en formato .cer (reglas de codificación distinguida (DER) binario codificado X.509 o X.509 codificado en Base 64 X.509. El certificado de cifrado se puede generar a partir de PKI de Microsoft, PKI de terceros o autofirmado.

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.
ERROR_FILE_NOT_FOUND
0000000002 (0x2)
 El sistema no puede archivar el archivo especificado.
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 con 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