Método ProtectKeyWithNumericalPassword de la clase Win32_EncryptableVolume

  • Artículo

El método ProtectKeyWithNumericalPassword de la clase Win32_EncryptableVolume protege la clave de cifrado del volumen con una contraseña de 48 dígitos con formato especial. Esta contraseña numérica se puede usar para recuperarse de los errores de autenticación de otros protectores de clave (por ejemplo, TPM).

Se crea un protector de clave de tipo "Contraseña numérica" para el volumen.

Use el método IsNumericalPasswordValid para validar el formato de la contraseña numérica.

Sintaxis

uint32 ProtectKeyWithNumericalPassword(
  [in, optional] string FriendlyName,
  [in, optional] string NumericalPassword,
  [out]          string VolumeKeyProtectorID
);

Parámetros

FriendlyName [in, optional]

Tipo: cadena

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

NumericPassword [in, optional]

Tipo: cadena

Cadena que especifica la contraseña numérica de 48 dígitos con formato especial.

La contraseña numérica debe contener 48 dígitos. Estos dígitos se pueden dividir en 8 grupos de 6 dígitos, con el último dígito de cada grupo que indica un valor de suma de comprobación para el grupo. Cada grupo de 6 dígitos debe ser divisible en 11 y debe ser 720885 o menos. Suponiendo que un grupo de seis dígitos se etiqueta como x1, x2, x3, x4, x5 y x6, la suma de comprobación x6 se calcula como –x1+x2–x3+x4–x5 mod 11.

Los grupos de dígitos pueden estar separados opcionalmente por un espacio o guion. Por lo tanto, "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx- xxxxxx" o "xxxxxx xxxxxx xxxxxx xxxxxx" también pueden contener contraseñas numéricas válidas.

Si no se especifica ninguna contraseña numérica, se genera una aleatoriamente. Use el método GetKeyProtectorNumericalPassword para obtener la contraseña generada aleatoriamente.

VolumeKeyProtectorID [out]

Tipo: cadena

Cadena que es el identificador único asociado al protector creado y que se puede usar para administrar el protector de clave.

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

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 NumericPassword no tiene un formato válido.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 El volumen está bloqueado.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
 El parámetro NumericPassword no tiene un formato válido.

 

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