Compartir a través de

Método ProtectKeyWithPassphrase de la clase Win32_EncryptableVolume

  • Artículo

El método ProtectKeyWithPassphrase de la clase Win32_EncryptableVolume usa la frase de contraseña para obtener la clave derivada. Una vez calculada la clave derivada, la clave derivada se usa para proteger la clave maestra del volumen cifrado.

Sintaxis

uint32 ProtectKeyWithPassphrase(
  [in, optional] string FriendlyName,
  [in]           string Passphrase,
  [out]          string VolumeKeyProtectorID
);

Parámetros

FriendlyName [in, opcional]

Tipo: cadena

Cadena que especifica un identificador de cadena asignado por el usuario para este protector de clave. Si no se especifica este parámetro, se usa un valor en blanco.

Frase de contraseña [in]

Tipo: cadena

Cadena que especifica la frase de contraseña.

VolumeKeyProtectorID [out]

Tipo: cadena

Cadena que identifica de forma única el protector de clave creado.

Si la unidad admite el cifrado de hardware y BitLocker no ha tomado la propiedad de banda, la cadena de identificador se establece en "BitLocker" y el protector de clave se escribe en por metadatos de banda.

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_ALLOWED_IN_SAFE_MODE
2150694976 (0x80310040)
 El cifrado de unidad BitLocker solo se puede usar con fines de recuperación cuando se usa en modo seguro.
FVE_E_POLICY_PASSPHRASE_NOT_ALLOWED
2150695018 (0x8031006A)
 La directiva de grupo no permite la creación de una frase de contraseña.
FVE_E_FIPS_PREVENTS_PASSPHRASE
2150695020 (0x8031006C)
 La configuración de directiva de grupo que requiere el cumplimiento de FIPS impidió que la frase de contraseña se generara o usara.
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
 La frase de contraseña proporcionada no cumple los requisitos de longitud mínima o máxima.
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
 La frase de contraseña no cumple los requisitos de complejidad establecidos por el administrador en la directiva de grupo.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 El volumen ya está bloqueado por el cifrado de unidad BitLocker. Debes desbloquear la unidad desde Panel de control.
FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)
 Otro subproceso actualizó el bloque de control del volumen cifrado.
FVE_E_KEY_PROTECTOR_NOT_SUPPORTED
2150695017 (0x80310069)
 El protector de clave no es compatible con la versión del cifrado de unidad BitLocker actualmente en el volumen.
FVE_E_OS_VOLUME_PASSPHRASE_NOT_ALLOWED
2150695021 (0x8031006D)
 La frase de contraseña no se puede agregar al volumen del sistema operativo.
FVE_E_PROTECTOR_EXISTS
2150694960 (0x80310030)
 El protector de clave proporcionado ya existe en este volumen.

 

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