[函式探索可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]
建立特定函式實例集合的查詢。
語法
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介面指標的指標。
傳回值
可能的傳回值包括，但不限於下列各項。
| 傳回碼/值 | 描述 |
|---|---|
|
已成功完成命令。 |
|
pszCategory或pIID的值無效。 ppIFunctionInstanceCollectionQuery參數中傳回的值為Null。 |
|
方法無法配置執行這項作業所需的記憶體。 |
|
pszCategory或pszSubCategory的值未知。 |
備註
如果指定 pIFunctionDiscoveryNotification ，則會啟用函式探索變更通知程式。 此參數可以是 Null。 不過，網路提供者不需要這麼做，因為它們不會傳回同步結果。 函式探索網路提供者只會透過 IFunctionDiscoveryNotification 介面傳回實例。
這個方法只會初始化查詢呼叫。 必須在ppIFunctionInstanceCollectionQuery介面中呼叫IFunctionInstanceCollectionQuery介面的Execute方法，才能執行查詢並傳回任何資料。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | functiondiscoveryapi.h |
| Dll | FunDisc.dll |