IVdsService::GetObject-Methode (vds.h)
[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 |
|---|---|
|
Ein Objekt mit dem angegebenen Bezeichner und Typ wurde nicht gefunden. |
|
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 |