Método ChangePIN da classe Win32_EncryptableVolume
O método ChangePIN da classe Win32_EncryptableVolume altera o PIN associado a um volume criptografado. Se a política de grupo "Permitir PINs aprimorados para inicialização" estiver habilitada, um PIN poderá conter letras, símbolos e espaços além de números.
Sintaxe
uint32 ChangePIN(
[in] string VolumeKeyProtectorID,
[in] string NewPIN
);
Parâmetros
-
VolumeKeyProtectorID [in]
-
Tipo: cadeia de caracteres
O identificador de cadeia de caracteres exclusivo usado para gerenciar um protetor de chave de volume criptografado.
-
NewPIN [in]
-
Tipo: cadeia de caracteres
Uma cadeia de caracteres de identificação pessoal especificada pelo usuário. Essa cadeia de caracteres deve consistir em uma sequência de 4 a 20 dígitos ou, se a política de grupo "Permitir PINs avançados para inicialização" estiver habilitada, de 4 a 20 letras, símbolos, espaços ou números.
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 |
|---|---|
|
O método foi bem-sucedido. |
|
Um CD/DVD inicializável é encontrado neste computador. Remova o CD/DVD e reinicie o computador. |
|
O parâmetro NewPIN contém caracteres que não são válidos. Quando a Política de Grupo "Permitir PINs aprimorados para inicialização" estiver desabilitada, somente números serão suportados. |
|
O parâmetro VolumeKeyProtectorID não se refere a um protetor de chave do tipo "Senha Numérica" ou "Chave Externa". Use o método ProtectKeyWithNumericalPassword ou ProtectKeyWithExternalKey para criar um protetor de chave do tipo apropriado. |
|
O volume está bloqueado. |
|
O BitLocker não está habilitado no volume. Adicione um protetor de chave para habilitar o BitLocker. |
|
O parâmetro NewPIN fornecido tem mais de 20 caracteres, menos de 4 caracteres ou menor que o comprimento mínimo especificado por Política de Grupo. |
|
O protetor de chave fornecido não existe no volume. |
|
Nenhum TPM (Trusted Platform Module) compatível é encontrado neste computador. |
Comentários
O método ChangePIN cria um novo protetor de TPM e PIN com base nas informações de protetor existentes e no PIN recém-fornecido. O novo protetor terá o mesmo GUID. O método ChangePIN também pode ser chamado para alterar o PIN de qualquer protetor de chave que use um PIN, por exemplo, TPM e PIN ou TPM com PIN e USB.
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 7 Enterprise, Windows 7 Ultimate [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Namespace |
Root\CIMV2\Security\MicrosoftVolumeEncryption |
| MOF |
|
Confira também