次の方法で共有


Win32_EncryptableVolume クラスの ChangePIN メソッド

Win32_EncryptableVolume クラスの ChangePIN メソッドは、暗号化されたボリュームに関連付けられている PIN を変更します。 [スタートアップに拡張 PIN を許可する] グループ ポリシーが有効になっている場合、PIN には数字に加えて文字、記号、スペースを含めることができます。

構文

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

パラメーター

VolumeKeyProtectorID [in]

型: string

暗号化されたボリューム キー保護機能の管理に使用される一意の文字列識別子。

NewPIN [in]

型: string

ユーザー指定の個人識別文字列。 この文字列は、4 ~ 20 桁のシーケンスで構成されている必要があります。または、"スタートアップに拡張 PIN を許可する" グループ ポリシーが有効になっている場合は、4 ~ 20 文字、記号、スペース、または数字が必要です。

戻り値

型: uint32

このメソッドは、次のいずれかのコードまたは失敗した場合に別のエラー コードを返します。

リターン コード/値 説明
S_OK
0 (0x0)
メソッドは正常に実行されました。
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
起動可能な CD/DVD がこのコンピューターにあります。 CD/DVD を削除し、コンピューターを再起動します。
FVE_E_INVALID_PIN_CHARS
2150695066 (0x8031009A)
NewPIN パラメーターには、無効な文字が含まれています。 [スタートアップに拡張 PIN を許可する] グループ ポリシーが無効になっている場合は、数値のみがサポートされます。
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
VolumeKeyProtectorID パラメーターは、型 "数値パスワード" または "外部キー" のキー保護機能を参照しません。 ProtectKeyWithNumericalPassword メソッドまたは ProtectKeyWithExternalKey メソッドを使用して、適切な型のキー 保護機能を作成します。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
ボリュームがロックされています。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。
FVE_E_POLICY_INVALID_PIN_LENGTH
2150695016 (0x80310068)
指定された NewPIN パラメーターは、20 文字より長い、4 文字より短い、またはグループ ポリシーで指定された最小長より短いのいずれかです。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
指定されたキー保護機能がボリューム上に存在しません。
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
互換性のあるトラステッド プラットフォーム モジュール (TPM) がこのコンピューターに見つかりません。

 

解説

ChangePIN メソッドは、既存の保護機能情報と新しく提供された PIN に基づいて、新しい TPM と PIN プロテクターを作成します。 新しいプロテクタは同じ GUID を持ちます。 CHANGEPIN メソッドを呼び出して、PIN を使用するキー保護機能の PIN (たとえば、TPM、PIN、USB を使用する TPM など) を変更することもできます。

マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Windows SDK の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

要件

要件
サポートされている最小のクライアント
Windows 7 Enterprise、Windows 7 Ultimate [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 R2 [デスクトップ アプリのみ]
名前空間
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

関連項目

Win32_EncryptableVolume