[함수 검색은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
특정 함수 인스턴스의 컬렉션에 대한 쿼리를 만듭니다.
구문
HRESULT CreateInstanceCollectionQuery(
[in] const WCHAR *pszCategory,
[in] const WCHAR *pszSubCategory,
[in] BOOL fIncludeAllSubCategories,
[in] IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
[in, out] FDQUERYCONTEXT *pfdqcQueryContext,
[out] IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);
매개 변수
[in] pszCategory
쿼리의 범주입니다. 범주 정의를 참조하세요.
[in] pszSubCategory
쿼리의 하위 범주입니다. 하위 범주 정의를 참조하세요. 이 매개 변수는 NULL일 수 있습니다.
하위 범주 쿼리는 계층화된 범주 및 일부 공급자 범주에 대해서만 지원됩니다. 레지스트리 공급자, PnP-X 연결 공급자 및 게시 공급자는 하위 범주 쿼리를 지원합니다. 사용자 지정 공급자는 하위 범주 쿼리를 지원하도록 명시적으로 설계할 수 있습니다. 즉, pszCategory 매개 변수가 FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION 또는 계층화된 범주 또는 하위 범주 쿼리를 지원하는 사용자 지정 공급자에 대해 정의된 사용자 지정 범주 값으로 설정된 경우에만 pszSubCategory 매개 변수를 NULL이 아닌 값으로 설정해야 합니다.
[in] fIncludeAllSubCategories
TRUE이면 이 메서드는 pszCategory에 지정된 범주의 모든 하위 범주에 대한 쿼리를 재귀적으로 만들어 pszCategory의 모든 하위 범주에서 함수 인스턴스를 포함하는 컬렉션을 반환합니다.
FALSE인 경우 이 메서드는 생성된 쿼리를 pszCategory로 지정된 범주의 함수 인스턴스 및 pszSubCategory로 지정된 하위 범주로 제한합니다.
[in] pIFunctionDiscoveryNotification
호출 애플리케이션에서 구현한 IFunctionDiscoveryNotification 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 포인터는 반환된 쿼리 개체가 해제될 때까지 유효합니다.
[in, out] pfdqcQueryContext
쿼리가 만들어진 컨텍스트에 대한 포인터입니다. FDQUERYCONTEXT 형식은 DWORDLONG으로 정의됩니다.
[out] ppIFunctionInstanceCollectionQuery
IFunctionInstanceCollectionQuery 인터페이스 포인터에 대한 포인터입니다.
반환 값
가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.
| 반환 코드/값 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
pszCategory 또는 pIID 값이 잘못되었습니다. ppIFunctionInstanceCollectionQuery 매개 변수에 반환된 값은 NULL입니다. |
|
메서드는 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다. |
|
pszCategory 또는 pszSubCategory의 값을 알 수 없습니다. |
설명
pIFunctionDiscoveryNotification이 지정된 경우 함수 검색 변경 알림 프로세스를 사용하도록 설정합니다. 이 매개 변수는 NULL일 수 있습니다. 그러나 네트워크 공급자는 동기 결과를 반환하지 않으므로 필요합니다. Function Discovery 네트워크 공급자는 IFunctionDiscoveryNotification 인터페이스를 통해서만 인스턴스를 반환합니다.
이 메서드는 쿼리 호출만 초기화합니다. 쿼리 를 수행하고 데이터를 반환하려면 ppIFunctionInstanceCollectionQuery에 반환된 IFunctionInstanceCollectionQuery 인터페이스의 Execute 메서드를 호출해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | functiondiscoveryapi.h |
| DLL | FunDisc.dll |