Método ProtectKeyWithNumericalPassword da classe Win32_EncryptableVolume

O método ProtectKeyWithNumericalPassword da classe Win32_EncryptableVolume protege a chave de criptografia do volume com uma senha de 48 dígitos formatada especialmente. Essa senha numérica pode ser usada para se recuperar das falhas de autenticação de outros protetores de chave (por exemplo, TPM).

Um protetor de chave do tipo "Senha Numérica" é criado para o volume.

Use o método IsNumericalPasswordValid para validar o formato da senha numérica.

Sintaxe

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

Parâmetros

FriendlyName [in, opcional]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que especifica um identificador atribuído pelo usuário para esse protetor de chave. Se esse parâmetro não for especificado, um valor em branco será usado.

NumericalPassword [in, opcional]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que especifica a senha numérica de 48 dígitos especialmente formatada.

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 720885 ou menos. 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 xxxxxx xxxx xxxxxx xxxx xxxx" também podem conter senhas numéricas válidas.

Se nenhuma senha numérica for especificada, uma será gerada aleatoriamente. Use o método GetKeyProtectorNumericalPassword para obter a senha gerada aleatoriamente.

VolumeKeyProtectorID [out]

Tipo: cadeia de caracteres

Uma cadeia de caracteres que é o identificador exclusivo associado ao protetor criado e que pode ser usada para gerenciar o protetor de chave.

Se a unidade der suporte à criptografia de hardware e o BitLocker não tiver tomado a propriedade da banda, a cadeia de caracteres de ID será definida como "BitLocker" e o protetor de chave será gravado por metadados de banda.

Valor retornado

Tipo: uint32

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

Retornar código/valor Descrição
S_OK
0 (0x0)
O método foi bem-sucedido.
E_INVALIDARG
2147942487 (0x80070057)
O parâmetro NumericalPassword não tem um formato válido.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
O volume está bloqueado.
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