Método ProtectKeyWithNumericalPassword de la clase Win32_EncryptableVolume
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 |
|---|---|
|
Método realizado correctamente. |
|
El parámetro NumericPassword no tiene un formato válido. |
|
El volumen está bloqueado. |
|
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 |
|
Vea también