IVdsService::GetObject-Methode (vds.h)

Artikel
03/06/2024

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

Gibt einen Objektzeiger für das identifizierte 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 gewünschten Objekts.

[in] type

Ein VDS_OBJECT_TYPE Enumerationswert, der den Objekttyp angibt. VDS_OT_UNKNOWN, VDS_OT_PROVIDER, VDS_OT_ASYNC, VDS_OT_ENUM und VDS_OT_OPEN_VDISK werden nicht unterstützt.

[out] ppObjectUnk

Ein Zeiger auf einen Puffer, der den IUnknown-Zeiger auf das -Objekt empfängt. 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	Ein Objekt mit dem angegebenen Bezeichner und Typ wurde nicht gefunden.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben.

Hinweise

VDS-Benachrichtigungen geben einen Objektbezeichner anstelle eines Objektzeigers zurück. Aufrufer verwenden diese Methode, um einen Zeiger auf das Objekt abzurufen, auf das in der Benachrichtigung verwiesen wird.

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	vds.h
Bibliothek	Uuid.lib

Weitere Informationen

IVdsService

VDS_OBJECT_TYPE

Freigeben über