Método UnlockWithNumericalPassword da classe Win32_EncryptableVolume

  • Artigo

O método UnlockWithNumericalPassword da classe Win32_EncryptableVolume usa uma senha numérica fornecida para acessar o conteúdo de um volume de dados.

A chave de criptografia do volume deve ter sido protegida com um ou mais protetores de chave do tipo "Senha Numérica" (usando o método ProtectKeyWithNumericalPassword ) para poder desbloquear o volume com esse método.

Observação

Se o disco der suporte à criptografia de hardware, essa função definirá a banda status como "desbloqueada""

 

Sintaxe

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

Parâmetros

NumericalPassword [in]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que especifica a senha numérica.

A senha numérica deve conter 48 dígitos. Esses dígitos podem ser divididos em 8 grupos de 6 dígitos, com o último dígito em cada grupo indicando um valor de soma de verificação para o grupo. Cada grupo de seis dígitos deve ser divisível por 11 e deve ser menor que 65536. Supondo que um grupo de seis dígitos seja rotulado como x1, x2, x3, x4, x5 e x6, o dígito x6 de soma de verificação é calculado como –x1+x2–x3+x4–x5 mod 11.

Opcionalmente, os grupos de dígitos podem ser separados por um espaço ou hífen. Portanto, "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" ou "xxxxxxx xxxxxx xxx xxxxx xxxxxx xxxxxx xxxxxx xxxxxx" também pode conter senhas numéricas válidas.

Valor retornado

Tipo: uint32

Esse método retornará um dos códigos a seguir ou outro código de erro se falhar.

Se o volume já estiver desbloqueado e nenhum outro erro ocorrer, esse método retornará 0.

Código/valor de retorno Descrição
S_OK
0 (0x0)
 O método foi bem-sucedido.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 O BitLocker não está habilitado no volume. Adicione um protetor de chave para habilitar o BitLocker.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 O volume não tem um protetor de chave do tipo "Senha Numérica".
O parâmetro NumericalPassword tem um formato válido, mas você não pode usar uma senha numérica para desbloquear o volume.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
 O parâmetro NumericalPassword não pode desbloquear o volume.
Existem um ou mais protetores de chave do tipo "Senha Numérica", mas o parâmetro NumericalPassword especificado não pode desbloquear o volume.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
 O parâmetro NumericalPassword não tem um formato válido.

 

Comentários

Os arquivos MOF (Managed Object Format) contêm as definições para classes WMI (Instrumentação de Gerenciamento do Windows). Os arquivos MOF não são instalados como parte do SDK do Windows. Eles são instalados no servidor quando você adiciona a função associada usando o Gerenciador do Servidor. Para obter mais informações sobre arquivos MOF, consulte MOF (Managed Object Format).

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista Enterprise, Windows Vista Ultimate [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Namespace
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Confira também

Win32_EncryptableVolume