IVdsProviderPrivate::GetObject-Methode (vdshwprv.h)

[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.

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

Weitere Informationen

IVdsProviderPrivate

VDS_OBJECT_TYPE