функция 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 или более поздняя)

См. также раздел

IServiceProvider

QueryService