fonction IUnknown_QueryService (shlwapi.h)
Récupère une interface pour un service à partir d’un objet spécifié.
Syntaxe
LWSTDAPI IUnknown_QueryService(
[in] IUnknown *punk,
[in] REFGUID guidService,
[in] REFIID riid,
[out] void **ppvOut
);
Paramètres
[in] punk
Type : IUnknown*
Pointeur vers le instance IUnknown de l’objet COM qui prend en charge le service.
[in] guidService
Type : REFGUID
Identificateur unique (SID) du service.
[in] riid
Type : REFIID
IID de l’interface de service souhaitée.
[out] ppvOut
Type : void**
Lorsque cette méthode retourne, contient le riid de pointeur d’interface demandé. En cas de réussite, l’application appelante est responsable de l’appel de IUnknown ::Release à l’aide de cette valeur lorsque le service n’est plus nécessaire. En cas d’échec, cette valeur est NULL.
Valeur retournée
Type : HRESULT
Retourne S_OK en cas de réussite. Retourne E_FAIL si l’objet ne prend pas en charge IServiceProvider. Sinon, la fonction retourne le HRESULT retourné par la méthode QueryService de l’objet.
Remarques
Si l’objet transmis dans le paramètre punk prend en charge l’interface IServiceProvider , sa méthode QueryService est appelée, transmettant les paramètres guidService, riid et ppvOut et propageant la valeur de retour. Sinon, la fonction retourne E_FAIL.
Pour les versions de Windows qui n’incluent pas IUnknown_QueryService dans Shlwapi.h, cette fonction doit être appelée directement à partir de Shlwapi.dll à l’aide de l’ordinal 176.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server, Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |