Compartir a través de

Método UnlockWithExternalKey de la clase Win32_EncryptableVolume

  • Artículo

El método UnlockWithExternalKey de la clase Win32_EncryptableVolume usa una clave externa proporcionada para acceder al contenido de un volumen de datos.

La clave de cifrado del volumen debe estar protegida con uno o varios protectores de clave del tipo "Clave externa" mediante el método ProtectKeyWithExternalKey para poder desbloquear el volumen con este método.

Nota

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

 

Sintaxis

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

Parámetros

ExternalKey [in]

Tipo: uint8[]

Matriz de bytes que especifica la clave externa de 256 bits usada para desbloquear el volumen. Esta clave se puede obtener llamando al método GetExternalKeyFromFile .

Valor devuelto

Tipo: uint32

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

Si el volumen ya está desbloqueado, este método devuelve 0.

Código o valor devuelto Descripción
S_OK
0 (0x0)
 Método realizado correctamente.
ERROR_NOT_FOUND
Ningún valor dado (0x)
 El volumen no tiene un protector de clave del tipo "Clave externa".
ERROR_INVALID_PASSWORD
Ningún valor dado (0x)
 Existen uno o varios protectores de clave del tipo "Clave externa", pero el parámetro ExternalKey especificado no puede desbloquear el volumen.
E_INVALIDARG
2147942487 (0x80070057)
 El parámetro ExternalKey no es una matriz de tamaño 4.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker no está habilitado en el volumen. Agregue un protector de clave para habilitar BitLocker.

 

Observaciones

Los archivos de Formato de objeto administrado (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte del SDK de Windows. Se instalan en el servidor cuando se agrega el rol asociado mediante el Administrador del servidor. Para obtener más información sobre los archivos MOF, vea Managed Object Format (MOF).

Requisitos

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

Vea también

Win32_EncryptableVolume