Método ChangePIN da classe Win32_EncryptableVolume

  • Artigo

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
S_OK
0 (0x0)
 O método foi bem-sucedido.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 Um CD/DVD inicializável é encontrado neste computador. Remova o CD/DVD e reinicie o computador.
FVE_E_INVALID_PIN_CHARS
2150695066 (0x8031009A)
 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.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 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.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 O volume está bloqueado.
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_POLICY_INVALID_PIN_LENGTH
2150695016 (0x80310068)
 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.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 O protetor de chave fornecido não existe no volume.
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
 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
Win32_encryptablevolume.mof

Confira também

Win32_EncryptableVolume