Método UnlockWithNumericalPassword de la clase Win32_EncryptableVolume

El método UnlockWithNumericalPassword de la clase Win32_EncryptableVolume usa una contraseña numérica proporcionada para tener acceso al contenido de un volumen de datos.

La clave de cifrado del volumen debe haberse protegido con uno o varios protectores de clave del tipo "Contraseña numérica" (mediante el método ProtectKeyWithNumericalPassword ) 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 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

Parámetros

NumericPassword [in]

Tipo: cadena

Cadena que especifica la contraseña numérica.

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 menor que 65536. 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 xxxxxx" también pueden contener contraseñas numéricas válidas.

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.

Si el volumen ya está desbloqueado y no se produce ningún otro error, este método devuelve 0.

Código o valor devuelto	Descripción
S_OK 0 (0x0)	Método realizado correctamente.
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	BitLocker no está habilitado en el volumen. Agregue un protector de clave para habilitar BitLocker.
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	El volumen no tiene un protector de clave del tipo "Contraseña numérica". El parámetro NumericPassword tiene un formato válido, pero no puede usar una contraseña numérica para desbloquear el volumen.
FVE_E_FAILED_AUTHENTICATION 2150694951 (0x80310027)	El parámetro NumericPassword no puede desbloquear el volumen. Existen uno o más protectores de clave del tipo "Contraseña numérica", pero el parámetro NumericPassword especificado no puede desbloquear el volumen.
FVE_E_INVALID_PASSWORD_FORMAT 2150694965 (0x80310035)	El parámetro NumericPassword no tiene un formato válido.

 

Observaciones

Los archivos managed Object Format (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte de Windows SDK. 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) (Formato de objeto administrado [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