IUnknown_QueryService-Funktion (shlwapi.h)

Ruft eine Schnittstelle für einen Dienst aus einem angegebenen -Objekt ab.

Syntax

LWSTDAPI IUnknown_QueryService(
  [in]  IUnknown *punk,
  [in]  REFGUID  guidService,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

Parameter

[in] punk

Typ: IUnknown*

Ein Zeiger auf die IUnknown-instance des COM-Objekts, das den Dienst unterstützt.

[in] guidService

Typ: REFGUID

Der eindeutige Bezeichner (SID) des Diensts.

[in] riid

Typ: REFIID

Die IID der gewünschten Dienstschnittstelle.

[out] ppvOut

Typ: void**

Wenn diese Methode zurückgibt, enthält den angeforderten Schnittstellenzeiger riid. Bei erfolgreicher Ausführung ist die aufrufende Anwendung dafür verantwortlich, IUnknown::Release mit diesem Wert aufzurufen, wenn der Dienst nicht mehr benötigt wird. Im Falle eines Fehlers ist dieser Wert NULL.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt E_FAIL zurück, wenn das Objekt IServiceProvider nicht unterstützt. Andernfalls gibt die Funktion das HRESULT zurück, das von der QueryService-Methode des Objekts zurückgegeben wird.

Hinweise

Wenn das im Punk-Parameter übergebene Objekt die IServiceProvider-Schnittstelle unterstützt, wird dessen QueryService-Methode aufgerufen, wobei die Parameter guidService, riid und ppvOut übergeben und der Rückgabewert weitergegeben wird. Andernfalls gibt die Funktion E_FAIL zurück.

Für windows-Versionen, die keine IUnknown_QueryService in Shlwapi.h enthalten, muss diese Funktion direkt aus Shlwapi.dll mithilfe von Ordinal 176 aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
DLL	Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

IServiceProvider

Queryservice