функция IUnknown_QueryService (shlwapi.h)
Извлекает интерфейс для службы из указанного объекта .
Синтаксис
LWSTDAPI IUnknown_QueryService(
[in] IUnknown *punk,
[in] REFGUID guidService,
[in] REFIID riid,
[out] void **ppvOut
);
Параметры
[in] punk
Тип: IUnknown*
Указатель на экземпляр IUnknown COM-объекта, который поддерживает службу.
[in] guidService
Тип: REFGUID
Уникальный идентификатор (SID) службы.
[in] riid
Тип: REFIID
Идентификатор IID требуемого интерфейса службы.
[out] ppvOut
Тип: void**
При возврате этого метода содержит указатель интерфейса, запрошенный riid. В случае успешного выполнения вызывающее приложение отвечает за вызов IUnknown::Release с помощью этого значения, когда служба больше не нужна. В случае сбоя это значение равно NULL.
Возвращаемое значение
Тип: HRESULT
В случае успешного выполнения возвращает S_OK. Возвращает E_FAIL , если объект не поддерживает IServiceProvider. В противном случае функция возвращает HRESULT , возвращенный методом QueryService объекта.
Комментарии
Если объект, переданный в параметре punk , поддерживает интерфейс IServiceProvider , вызывается его метод QueryService , передавая параметры guidService, riid и ppvOut и распространяя возвращаемое значение. В противном случае функция возвращает E_FAIL.
Для тех версий Windows, которые не содержат IUnknown_QueryService в Shlwapi.h, эта функция должна вызываться непосредственно из Shlwapi.dll с помощью порядкового номера 176.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server, Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlwapi.h |
| DLL | Shlwapi.dll (версия 5.0 или более поздняя) |