IFunctionDiscovery::CreateInstanceQuery 메서드(functiondiscoveryapi.h)

[Function Discovery는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

특정 함수 instance 대한 쿼리를 만듭니다.

구문

HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery
);

매개 변수

[in] pszFunctionInstanceIdentity

함수 instance 식별자입니다.

[in] pIFunctionDiscoveryNotification

호출 애플리케이션에서 구현한 IFunctionDiscoveryNotification 인터페이스에 대한 포인터입니다. 지정된 경우 함수 검색 변경 알림 프로세스를 사용하도록 설정합니다. 이 매개 변수는 NULL일 수 있습니다. 그러나 네트워크 공급자에게는 필요합니다.

[in, out] pfdqcQueryContext

쿼리가 만들어진 컨텍스트에 대한 포인터입니다. FDQUERYCONTEXT 형식은 DWORDLONG으로 정의됩니다.

[out] ppIFunctionInstanceQuery

생성된 쿼리를 반환하는 데 사용되는 IFunctionInstanceQuery 인터페이스 포인터에 대한 포인터입니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_INVALIDARG	ppIFunctionInstanceQuery 는 NULL입니다.
E_OUTOFMEMORY	메서드는 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다.

설명

함수 검색 네트워크 공급자는 IFunctionDiscoveryNotification 인터페이스를 통해서만 인스턴스를 반환합니다.

이 메서드는 쿼리 호출만 초기화합니다. 쿼리를 수행하고 데이터를 반환하려면 ppIFunctionInstanceQuery에서 반환된 IFunctionInstanceQuery 인터페이스의 Execute 메서드를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	functiondiscoveryapi.h
DLL	FunDisc.dll

추가 정보

함수 검색 쿼리

IFunctionDiscovery