VDS_LUN_PROP 構造体 (vdshwprv.h)

[アーティクル]
03/13/2024

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

LUN オブジェクトのプロパティを定義します。

構文

typedef struct _VDS_LUN_PROP {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  LPWSTR               pwszUnmaskingList;
  ULONG                ulFlags;
  VDS_LUN_TYPE         type;
  VDS_LUN_STATUS       status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  SHORT                sRebuildPriority;
} VDS_LUN_PROP, *PVDS_LUN_PROP;

メンバー

id

LUN オブジェクトの GUID。

ullSize

LUN のサイズ (バイト単位)。

pwszFriendlyName

LUN の名前。人間が読み取り可能な 0 で終わる文字列。

pwszIdentification

一意の LUN 識別子。人間が読み取り可能な 0 で終わる文字列。

pwszUnmaskingList

LUN へのアクセスを許可するネットワーク上のコンピューターを指定するリスト。セミコロンで区切られた NULL で終わる、人間が読み取り可能な文字列。

値が "*" の場合、ネットワーク上のすべてのコンピューターに LUN へのアクセスが許可されます。値が "" の場合、LUN へのアクセスを許可するコンピューターはありません。

メモ実際には、値が "*" の場合、ほとんどのハードウェアプロバイダーは、ローカルコンピューター上のポートとイニシエーターにのみ LUN へのアクセスを許可します。

"*" または "" を指定した場合、他の値を指定することはできません。

ファイバーチャネルネットワークとシリアル接続 SCSI (SAS) ネットワークの場合、各エントリは、LUN がマスク解除されている各ポートの 64 ビットのワールドワイド名 (WWN) で、16 進文字列 (16 文字の長さ)、最も重要なバイトとして最初に書式設定されます。たとえば、WWN アドレス 01:23:45:67:89:AB:CD:EF は "0123456789ABCDEF" として表されます。詳細については、ファイバーチャネルと SAS の T10 仕様を参照してください。

iSCSI ネットワークの場合、各エントリは、LUN がマスク解除される各イニシエーターの iSCSI 修飾名 (IQN) です。特定のイニシエーターにマスクされていない LUN は、そのイニシエーターに関連付けられていると見なされます。

メモマスク解除リストには、同じ WWN または IQN を複数回含めることができます。重複は無視されます。

ulFlags

VDS_LUN_FLAGによって列挙される LUN フラグ。

type

VDS_LUN_TYPEによって列挙される LUN の種類。

status

VDS_LUN_STATUSによって列挙された LUN オブジェクトの状態。

health

LUN の正常性状態を指定するVDS_HEALTH列挙値。このメンバーの有効な値を次に示します。

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_REBUILDING (2)

VDS_H_FAILING (4)

VDS_H_FAILING_REDUNDANCY (5)

VDS_H_FAILED_REDUNDANCY (6)

VDS_H_FAILED_REDUNDANCY_FAILING (7)

VDS_H_FAILED (8)

TransitionState

VDS_TRANSITION_STATEによって列挙された LUN の遷移状態。

sRebuildPriority

LUN オブジェクトのリビルド優先度。 0 (最も低い優先度) から 15 (最も高い優先度) の値。

注釈

IVds Lun::GetProperties メソッドは、LUN オブジェクトのプロパティを報告するためにこの構造体を返します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	vdshwprv.h