Método GetKeyProtectorNumericalPassword da classe Win32_EncryptableVolume

  • Artigo

O método GetKeyProtectorNumericalPassword da classe Win32_EncryptableVolume recupera a senha numérica para um determinado protetor de chave do tipo apropriado.

O identificador do protetor de chave deve se referir a um protetor de chave do tipo "Senha Numérica".

Sintaxe

uint32 GetKeyProtectorNumericalPassword(
  [in]  string VolumeKeyProtectorID,
  [out] string NumericalPassword
);

Parâmetros

VolumeKeyProtectorID [in]

Tipo: cadeia de caracteres

Um identificador de cadeia de caracteres exclusivo usado para gerenciar um protetor de chave de volume criptografado.

NumericalPassword [out]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que representa a senha que pode ser usada para desbloquear o volume correspondente.

A senha numérica é de 48 dígitos. Esses dígitos são divididos em 8 grupos de seis dígitos, com o último dígito em cada grupo indicando um valor de soma de verificação para o grupo. 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.

Os grupos de dígitos são separados por um hífen. Portanto, "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" é o formato da senha retornada.

Valor retornado

Tipo: uint32

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

Código/valor de retorno Descrição
S_OK
0 (0x0)
 O método foi bem-sucedido.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 O volume está bloqueado.
E_INVALIDARG
2147942487 (0x80070057)
 O parâmetro VolumeKeyProtectorID não se refere a um protetor de chave do tipo "Senha Numérica".
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 O BitLocker não está habilitado no volume. Adicione um protetor de chave para habilitar o BitLocker.

 

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