IVdsProviderPrivate::GetObject-Methode (vdshwprv.h)

  • Artikel

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

Gibt das angegebene Objekt zurück.

Syntax

HRESULT GetObject(
  [in]  VDS_OBJECT_ID   ObjectId,
  [in]  VDS_OBJECT_TYPE type,
  [out] IUnknown        **ppObjectUnk
);

Parameter

[in] ObjectId

Die GUID des -Objekts.

[in] type

Der von VDS_OBJECT_TYPE aufgelistete Objekttyp.

[out] ppObjectUnk

Die Adresse eines IUnknown-Zeigers für das Objekt. Wenn der Zeiger nicht mehr benötigt wird, sollte der Aufrufer ihn freigeben, indem er die IUnknown::Release-Methode aufruft.

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/-wert BESCHREIBUNG
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Das Objekt wurde nicht gefunden.

Hinweise

Das Objekt kann ein Subsystem, Controller, LUN, LUN-Plex-, Drive-, Pack-, Datenträger-, Volume- oder Volumeplexobjekt sein. Jedes Objekt stellt ein physisches Gerät (z. B. ein Subsystem, Laufwerk oder Controller) oder ein virtuelles Gerät (z. B. ein LUN- oder LUN-Plex) dar. Der Hardwareanbieter sollte ein COM-Objekt für jedes physische oder virtuelle Gerät erstellen.

Anforderungen

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

Weitere Informationen

IVdsProviderPrivate

VDS_OBJECT_TYPE