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) |