Função IUnknown_QueryService (shlwapi.h)
Recupera uma interface para um serviço de um objeto especificado.
Sintaxe
LWSTDAPI IUnknown_QueryService(
[in] IUnknown *punk,
[in] REFGUID guidService,
[in] REFIID riid,
[out] void **ppvOut
);
Parâmetros
[in] punk
Tipo: IUnknown*
Um ponteiro para a instância IUnknown do objeto COM que dá suporte ao serviço.
[in] guidService
Tipo: REFGUID
SID (identificador exclusivo) do serviço.
[in] riid
Tipo: REFIID
A IID da interface de serviço desejada.
[out] ppvOut
Tipo: void**
Quando esse método retorna, contém o ponteiro de interface solicitado riid. Se tiver êxito, o aplicativo de chamada será responsável por chamar IUnknown::Release usando esse valor quando o serviço não for mais necessário. No caso de falha, esse valor é NULL.
Retornar valor
Tipo: HRESULT
Retorna S_OK se tiver êxito. Retornará E_FAIL se o objeto não oferecer suporte a IServiceProvider. Caso contrário, a função retorna o HRESULT retornado pelo método QueryService do objeto.
Comentários
Se o objeto passado no parâmetro punk der suporte à interface IServiceProvider , seu método QueryService será invocado, passando os parâmetros guidService, riid e ppvOut e propagando o valor retornado. Caso contrário, a função retornará E_FAIL.
Para as versões do Windows que não incluem IUnknown_QueryService no Shlwapi.h, essa função deve ser chamada diretamente de Shlwapi.dll usando o ordinal 176.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlwapi.h |
| DLL | Shlwapi.dll (versão 5.0 ou posterior) |