Método ChangePIN de la clase Win32_EncryptableVolume

  • Artículo

El método ChangePIN de la clase Win32_EncryptableVolume cambia el PIN asociado a un volumen cifrado. Si la directiva de grupo "Permitir PIN mejorados para el inicio" está habilitada, un PIN puede contener letras, símbolos y espacios además de números.

Sintaxis

uint32 ChangePIN(
  [in] string VolumeKeyProtectorID,
  [in] string NewPIN
);

Parámetros

VolumeKeyProtectorID [in]

Tipo: cadena

Identificador de cadena único que se usa para administrar un protector de clave de volumen cifrado.

NewPIN [in]

Tipo: cadena

Cadena de identificación personal especificada por el usuario. Esta cadena debe constar de una secuencia de 4 a 20 dígitos o, si la directiva de grupo "Permitir PIN mejorados para el inicio" está habilitada, de 4 a 20 letras, símbolos, espacios o números.

Valor devuelto

Tipo: uint32

Este método devuelve uno de los códigos siguientes u otro código de error si se produce un error.

Código o valor devuelto Descripción
S_OK
0 (0x0)
 Método realizado correctamente.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 En este equipo se encuentra un CD/DVD de arranque. Quite el CD/DVD y reinicie el equipo.
FVE_E_INVALID_PIN_CHARS
2150695066 (0x8031009A)
 El parámetro NewPIN contiene caracteres que no son válidos. Cuando el directiva de grupo "Permitir PIN mejorados para el inicio" está deshabilitado, solo se admiten números.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 El parámetro VolumeKeyProtectorID no hace referencia a un protector de clave del tipo "Contraseña numérica" o "Clave externa". Use el método ProtectKeyWithNumericalPassword o ProtectKeyWithExternalKey para crear un protector de clave del tipo adecuado.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 El volumen está bloqueado.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker no está habilitado en el volumen. Agregue un protector de clave para habilitar BitLocker.
FVE_E_POLICY_INVALID_PIN_LENGTH
2150695016 (0x80310068)
 El parámetro NewPIN proporcionado tiene más de 20 caracteres, menos de 4 caracteres o menor que la longitud mínima especificada por directiva de grupo.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 El protector de clave proporcionado no existe en el volumen.
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
 No se encuentra ningún módulo de plataforma segura (TPM) compatible en este equipo.

 

Comentarios

El método ChangePIN crea un nuevo protector TPM y PIN basado en la información del protector existente y el PIN recién proporcionado. El nuevo protector tendrá el mismo GUID. También se puede llamar al método ChangePIN para cambiar el PIN de cualquier protector de clave que use un PIN, por ejemplo, TPM y TPM o TPM con PIN y USB.

Los archivos managed Object Format (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte de Windows SDK. Se instalan en el servidor cuando se agrega el rol asociado mediante el Administrador del servidor. Para obtener más información sobre los archivos MOF, vea Managed Object Format (MOF) (Formato de objeto administrado [MOF]).

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 Enterprise, Windows 7 Ultimate [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2008 R2 [solo aplicaciones de escritorio]
Espacio de nombres
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Consulte también

Win32_EncryptableVolume