CHANGE_ATTRIBUTES_PARAMETERS構造体 (vds.h)

[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。

パーティション スタイルのパーティション パラメーターを定義します。

構文

typedef struct _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

メンバー

style

パーティション パラメーターを決定します。 サポートされている値は 、VDS_PST_MBR または VDS_PST_GPTです。

MbrPartInfo

スタイルがVDS_PST_MBR場合使用されます。 マスター ブート レコード (MBR) ディスクのパラメーター。

MbrPartInfo.bootIndicator

TRUE の場合、パーティションはアクティブであり、起動できます。それ以外の場合、パーティションを使用してシステムを起動することはできません。

GptPartInfo

styleVDS_PST_GPT場合に使用されます。 GUID パーティション テーブル (GPT) ディスクのパラメーター。

GptPartInfo.attributes

パーティションの属性。 これは、次の値のなかから 1 つまたは複数を指定できます。

意味
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
この属性が設定されている場合は、コンピューターが正しく機能するためにパーティションが必要です。

たとえば、この属性は OEM パーティションに設定する必要があります。 この属性が設定されている場合は、DiskPart.exe ユーティリティを使用して、パーティションの削除などのパーティション操作を実行できることに注意してください。 ただし、パーティションはボリュームではないので、DiskPart.exe ユーティリティを使用してパーティションに対してボリューム操作を実行することはできません。

この属性は、基本ディスクとダイナミック ディスクに設定できます。 ベーシック ディスク上のパーティションに対して設定され、ディスクがダイナミック ディスクに変換される場合、ディスクの残りの部分は動的ディスクであっても、パーティションはベーシック パーティションのままです。 これは、パーティションが GPT ディスク上の OEM パーティションと見なされるためです。

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
この属性が設定されている場合、ディスクが別のコンピューターに移動されたとき、またはディスクがコンピューターによって初めて表示されるときに、パーティションは既定でドライブ文字を受け取りません。

この属性は、SAN 環境で役立ちます。

名前に関わらず、この属性は Basic ディスクとダイナミック ディスクに設定できます。

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
この属性が設定されている場合、パーティションはマウント マネージャーによって検出されません。

その結果、パーティションはドライブ文字を受け取らず、ボリューム GUID パスを受け取らず、マウントされたフォルダー (ボリューム マウント ポイントとも呼ばれます) をホストせず、 FindFirstVolumeFindNextVolume の呼び出しによって列挙されません。 これにより、ディスク デフラグなどのアプリケーションがパーティションにアクセスしないようにします。 ボリューム シャドウ コピー サービス (VSS) はこの属性を使用します。

名前に関わらず、この属性は Basic ディスクとダイナミック ディスクに設定できます。

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
この属性が設定されている場合、パーティションは別のパーティションのシャドウ コピーです。

この属性は、ボリューム シャドウ コピー サービス (VSS) によって使用されます。 この属性は、ボリュームへのアタッチを回避するために、ファイル システム フィルター ドライバー ベースのソフトウェア (ウイルス対策プログラムなど) を示します。

アプリケーションでは、 属性を使用して、シャドウ コピー ボリュームと運用ボリュームを区別できます。 たとえば、高速復旧を実行するアプリケーションでは、読み取り専用属性と非表示属性とこの属性をクリアすることで、シャドウ コピー LUN が中断されます。 この属性は、シャドウ コピーが作成されるときに設定され、シャドウ コピーが破損したときにクリアされます。

名前に関わらず、この属性は Basic ディスクとダイナミック ディスクに設定できます。

Windows Server 2003: この属性は、Windows Server 2003 SP1 より前ではサポートされていません。

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
この属性が設定されている場合、パーティションは読み取り専用です。

パーティションへの書き込み要求はすべて失敗します。 IOCTL_DISK_IS_WRITABLE は、ERROR_WRITE_PROTECT Win32 エラー コードで失敗します。これにより、ファイル システムが存在する場合、ファイル システムが読み取り専用としてマウントされます。

VSS はこの属性を使用します。

ダイナミック ディスクには、この属性を設定しないでください。 これを設定すると、I/O エラーが発生し、ファイル システムが正しくマウントされない可能性があります。

解説

IVdsAdvancedDisk::ChangeAttributes メソッドは、この構造体をパラメーターとして受け取ります。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー vds.h

関連項目

IVdsAdvancedDisk::ChangeAttributes

VDS 構造体