ストレージ プール オブジェクトの属性値を設定または変更します。
構文
UInt32 SetAttributes(
[in] Boolean IsReadOnly,
[in] Boolean ClearOnDeallocate,
[in] Boolean IsPowerProtected,
[in] UInt16 RepairPolicy,
[in] UInt16 RetireMissingPhysicalDisks,
[in] UInt16 ThinProvisioningAlertThresholds[],
[out] String ExtendedStatus
);
パラメーター
IsReadOnly [in]
ストレージ プールの構成が読み取り専用かどうかを示します。 TRUE の場合、そのストレージ プールではプロパティまたは関連する要素の変更はできません。
ClearOnDeallocate [in]
TRUE の場合、ストレージ プールのマップ解除または削除時に、物理ディスクをゼロにする (すべてのデータをクリアする) 必要があります。 FALSE の場合、動作はサブシステムによって定義されます。
IsPowerProtected [in]
TRUE の場合、このプール内のディスクは、データ損失なしで電力損失に耐えることができます。 たとえば、外部電源が切断された後、揮発性バッファーを自動的に不揮発性メディアにフラッシュします。
RepairPolicy [in]
オペレーティング システムがこのストレージ プールの仮想ディスクを修復する方法。
| Value | 意味 |
|---|---|
| 2 | シーケンシャル - 一度に 1 つの割り当てスラブを処理します。 修復にかかる時間は長くなりますが、I/O 負荷への影響は少なくなります。 |
| 3 | 並列 - できるだけ多くの割り当てスラブを並列に処理します。 修復時間は最小限に抑えられますが、I/O 負荷に大きな影響を与えます。 |
RetireMissingPhysicalDisks [in]
ストレージ サブシステムが、このストレージ プールに存在しない物理ディスクを自動的にインベントリから削除し、ホット スペアまたはストレージ プールで使用可能な他の物理ディスクに置き換えるかどうかを指定します。
Auto (1)
Always (2)
Never (3)
ThinProvisioningAlertThresholds [in]
さまざまなスパース (仮想プロビジョニング) しきい値を表すパーセンテージ値の配列。 各値の最小値は 1 です。最大値は 100 です。 仮想ディスク領域の使用量がこれらのしきい値のいずれかを超えると、サブスクライブしているすべてのクライアントに通知がブロードキャストされます。
ExtendedStatus [out]
埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。
このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。
戻り値
Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Access denied (40001)
リソース不足のため、操作を完了できません。 (40002)
ストレージ プロバイダーに接続できません。 (46000)
ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)
この操作は、プリモディアル ストレージ プールではサポートされていません。 (48000)
ストレージ プールの正常性状態または動作状態により、操作を完了できませんでした。 (48006)
ストレージ プールの構成が読み取り専用であるため、操作を完了できませんでした。 (48007)
指定された仮想プロビジョニング アラートのしきい値の数が、このストレージ プールの制限を超えています。 (48009)
解説
すべてのパラメーターを指定する必要はありません。また、指定されたパラメーターのみが更新されます。
IsReadOnly プロパティを TRUE に設定するときには、単独で設定する必要があり、最後に設定する属性である必要があります。
IsReadOnly、ClearOnDeallocate、および IsPowerProtected プロパティを設定する場合:
- このメソッドを呼び出して、ClearOnDeallocate および IsPowerProtected パラメーターとして適切な値を指定し、IsReadOnly パラメーターには FALSE を指定します。
- IsReadOnly プロパティをTRUE にする必要がある場合は、このメソッドをもう一度呼び出して、IsReadOnly パラメーターに TRUE を指定します。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |