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
このメソッドは、次のいずれかのコードまたは失敗した場合に別のエラー コードを返します。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
起動可能な CD/DVD がこのコンピューターにあります。 CD/DVD を削除し、コンピューターを再起動します。 |
|
NewPIN パラメーターには、無効な文字が含まれています。 [スタートアップに拡張 PIN を許可する] グループ ポリシーが無効になっている場合は、数値のみがサポートされます。 |
|
VolumeKeyProtectorID パラメーターは、型 "数値パスワード" または "外部キー" のキー保護機能を参照しません。
ProtectKeyWithNumericalPassword メソッドまたは ProtectKeyWithExternalKey メソッドを使用して、適切な型のキー 保護機能を作成します。 |
|
ボリュームがロックされています。 |
|
ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。 |
|
指定された NewPIN パラメーターは、20 文字より長い、4 文字より短い、またはグループ ポリシーで指定された最小長より短いのいずれかです。 |
|
指定されたキー保護機能がボリューム上に存在しません。 |
|
互換性のあるトラステッド プラットフォーム モジュール (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 |
|
関連項目