IObjectProvider::QueryObject-Methode (shobjidl_core.h)

Artikel
03/04/2024

Abfragen für ein angegebenes Objekt.

Syntax

HRESULT QueryObject(
  [in]  REFGUID guidObject,
  [in]  REFIID  riid,
  [out] void    **ppvOut
);

Parameter

[in] guidObject

Typ: REFGUID

Ein Verweis auf die GUID , die zum Identifizieren des Objekts verwendet wird.

[in] riid

Typ: REFIID

Gibt die gewünschte Schnittstellen-ID an.

[out] ppvOut

Typ: void**

Enthält bei Erfolg die Adresse eines Zeigers auf das durch riid angegebene Objekt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Objektimplementierer, die die Ermittlung anderer Objekte aktivieren möchten, die sie erstellen können oder die sie enthalten, sollten IObjectProvider::QueryObject implementieren und die GUID-Werte veröffentlichen, die diese Objekte für Clients dieses Objekts benennen. Beachten Sie, dass Objekte die Anforderung für ein Objekt nicht an andere Objekte wie QueryService übergeben sollten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Freigeben über