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 이상) |