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 |
|---|---|
|
O método foi bem-sucedido. |
|
O parâmetro NumericalPassword não tem um formato válido. |
|
O volume está bloqueado. |
|
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 |
|
Confira também