Share via

IVdsLunNumber::GetLunNumber-Methode (vds.h)

  • Artikel

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

Ruft die LUN-Nummer für eine LUN ab.

Syntax

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

Parameter

[out] pulLunNumber

Die Adresse einer Variablen, die die LUN-Nummer empfängt. Dieser Wert ist erforderlich und darf nicht NULL sein.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.

Bemerkungen

Diese Methode gibt die LUN-Nummer zurück, die der VDS-Hardwareanbieter der LUN zugewiesen hat. Diese Nummer identifiziert die LUN innerhalb des Datenträgerarrays. Sie entspricht nicht der "Logical Unit Number" in der SCSI-Adresse des Datenträgers. Jeder LUN im Datenträgerarray wird genau eine LUN-Nummer zugewiesen.

Diese Methode ist vorhanden, da das DiskRAID-Hilfsprogramm jeder LUN einen eigenen Index zuweist, wenn es die LUNs in einem Subsystem aufzählt. Diese Indizes können sich jedoch bei jeder Ausführung von DiskRAID ändern, wenn der Hardwareanbieter die LUNs in einer anderen Reihenfolge aufzählt. Dies kann für Endbenutzer verwirrend sein. Bei Datenträgerarrays, die über eigene (vom Anbieter zugewiesene) LUN-Nummern verfügen, gibt diese Methode dem Aufrufer die Möglichkeit, die LUN-Nummern den LUN-Indizes zuzuordnen, die von DiskRAID zugewiesen werden.

Wenn ein Subsystem die LUN-Nummerierung unterstützt, kann es diese Unterstützung angeben, indem das VDS_SF_SUPPORTS_LUN_NUMBER-Flag im ulFlags-Member der VDS_SUB_SYSTEM_PROP - oder VDS_SUB_SYSTEM_PROP2-Struktur festgelegt wird. Weitere Informationen zu diesem Flag finden Sie in der VDS_SUB_SYSTEM_FLAG-Enumeration .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsLunNumber