Compartir a través de

Método ChangeExternalKey de la clase Win32_EncryptableVolume

  • Artículo

El método ChangeExternalKey de la clase Win32_EncryptableVolume cambia una clave externa asociada a un volumen cifrado.

Sintaxis

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

Parámetros

VolumeKeyProtectorID [in]

Tipo: cadena

Identificador de cadena único que se usa para administrar un protector de clave de volumen cifrado.

NewExternalKey [in, optional]

Tipo: uint8[]

Matriz de bytes que especifica la clave externa de 256 bits usada para desbloquear el volumen.

NewVolumeKeyProtectorID [out]

Tipo: cadena

Identificador de cadena único actualizado que se usa para administrar un protector de clave de volumen cifrado.

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.

Código o valor devuelto Descripción
S_OK
0 (0x0)
 Método realizado correctamente.
E_INVALIDARG
2147942487 (0x80070057)
 El parámetro NewExternalKey no es una matriz de tamaño 32.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 El volumen está bloqueado.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker no está habilitado en el volumen. Agregue un protector de clave para habilitar BitLocker.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 En este equipo se encuentra un CD/DVD de arranque. Quite el CD/DVD y reinicie el equipo.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 El protector de clave proporcionado no existe en el volumen.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 El parámetro VolumeKeyProtectorID no hace referencia a un protector de clave del tipo "Contraseña numérica" o "Clave externa". Use el método ProtectKeyWithNumericalPassword o ProtectKeyWithExternalKey para crear un protector de clave del tipo adecuado.

 

Comentarios

Este método se puede usar para cambiar la clave externa de cualquier protector de clave que use una clave externa.

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