IUnknown_QueryService 함수(shlwapi.h)

지정된 개체에서 서비스에 대한 인터페이스를 검색합니다.

구문

LWSTDAPI IUnknown_QueryService(
  [in]  IUnknown *punk,
  [in]  REFGUID  guidService,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

매개 변수

[in] punk

형식: IUnknown*

서비스를 지원하는 COM 개체의 IUnknown instance 대한 포인터입니다.

[in] guidService

형식: REFGUID

서비스의 SID(고유 식별자)입니다.

[in] riid

형식: REFIID

원하는 서비스 인터페이스의 IID입니다.

[out] ppvOut

형식: void**

이 메서드가 반환되면 는 요청된 riid 인터페이스 포인터를 포함합니다. 성공한 경우 호출 애플리케이션은 서비스가 더 이상 필요하지 않을 때 이 값을 사용하여 IUnknown::Release 를 호출합니다. 실패의 경우 이 값은 NULL입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환합니다. 개체가 IServiceProvider를 지원하지 않는 경우 E_FAIL 반환합니다. 그렇지 않으면 함수는 개체의 QueryService 메서드에서 반환된 HRESULT를 반환합니다.

설명

펑크 매개 변수에 전달된 개체가 IServiceProvider 인터페이스를 지원하는 경우 해당 QueryService 메서드가 호출되어 guidService, riid 및 ppvOut 매개 변수를 전달하고 반환 값을 전파합니다. 그렇지 않으면 함수는 E_FAIL 반환합니다.

Shlwapi.h에 IUnknown_QueryService 포함하지 않는 Windows 버전의 경우 서수 176을 사용하는 Shlwapi.dll 이 함수를 직접 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server, Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
DLL	Shlwapi.dll(버전 5.0 이상)

추가 정보

IServiceProvider

QueryService