VDS_LUN_PROP-Struktur (vdshwprv.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Definiert die Eigenschaften eines LUN-Objekts.

Syntax

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;

Member

id

Die GUID des LUN-Objekts.

ullSize

Die Größe der LUN in Bytes.

pwszFriendlyName

Der Name der LUN; eine Zeichenfolge mit Null-Endung, die für Menschen lesbar ist.

pwszIdentification

Der eindeutige LUN-Bezeichner; eine Zeichenfolge mit Null-Endung, die für Menschen lesbar ist.

pwszUnmaskingList

Eine Liste, die die Computer im Netzwerk angibt, denen der Zugriff auf die LUN gewährt werden soll; eine durch Semikolons getrennte, NULL-beendete, für Menschen lesbare Zeichenfolge.

Wenn der Wert "*" lautet, soll allen Computern im Netzwerk Zugriff auf die LUN gewährt werden. Wenn der Wert "" ist, soll keinem Computer Zugriff auf die LUN gewährt werden.

Hinweis In der Praxis gewähren die meisten Hardwareanbieter nur den Ports und Initiatoren auf dem lokalen Computer Zugriff auf die LUN, wenn der Wert "*" lautet.

Wenn "*" oder "" angegeben ist, kann kein anderer Wert angegeben werden.

Für Fibre Channel-Netzwerke und sas-Netzwerke (Serial Attached SCSI) ist jeder Eintrag ein 64-Bit World Wide Name (WWN) jedes Ports, an den die LUN entmasket ist, und formatiert als hexadezimale Zeichenfolge (16 Zeichen lang), wobei das wichtigste Byte zuerst ist. Beispielsweise wird eine WWN-Adresse von 01:23:45:67:89:AB:CD:EF als "0123456789ABCDEF" dargestellt. Weitere Informationen finden Sie in den T10-Spezifikationen für Fibre Channel und SAS.

Bei iSCSI-Netzwerken ist jeder Eintrag ein iSCSI-qualifizierter Name (IQN) jedes Initiators, für den die LUN enttarnt wird. Eine LUN, die einem bestimmten Initiator enttarnt wurde, gilt als mit diesem Initiator verknüpft.

Hinweis Die Entlarmungsliste kann denselben WWN oder IQN mehr als einmal enthalten. Duplikate werden ignoriert.

ulFlags

Die von VDS_LUN_FLAG aufgelisteten LUN-Flags.

type

Der LUN-Typ, der von VDS_LUN_TYPE aufgelistet wird.

status

Die status des LUN-Objekts, das von VDS_LUN_STATUS aufgelistet wird.

health

Ein VDS_HEALTH Enumerationswert, der den Integritätszustand der LUN angibt. Im Folgenden sind die gültigen Werte für dieses Element aufgeführt.

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

Der Übergangszustand der LUN, die von VDS_TRANSITION_STATE aufgelistet wird.

sRebuildPriority

Die Neuerstellungspriorität des LUN-Objekts. Ein Wert zwischen 0 (niedrigste Priorität) und 15 (höchste Priorität).

Hinweise

Die IVdsLun::GetProperties-Methode gibt diese Struktur zurück, um die Eigenschaften eines LUN-Objekts zu melden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vdshwprv.h