[函式探索可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]
建立特定函式實例的查詢。
語法
HRESULT CreateInstanceQuery(
[in] const WCHAR *pszFunctionInstanceIdentity,
[in] IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
[in, out] FDQUERYCONTEXT *pfdqcQueryContext,
[out] IFunctionInstanceQuery **ppIFunctionInstanceQuery
);
參數
[in] pszFunctionInstanceIdentity
函式實例的標識碼。
[in] pIFunctionDiscoveryNotification
呼叫應用程式所實作 之 IFunctionDiscoveryNotification 介面的指標。 如果指定,它會啟用函式探索變更通知程式。 此參數可以是 NULL;不過,網路提供者需要它。
[in, out] pfdqcQueryContext
建立查詢之內容的指標。 FDQUERYCONTEXT 類型定義為 DWORDLONG。
[out] ppIFunctionInstanceQuery
IFunctionInstanceQuery 介面指標的指標,用來傳回產生的查詢。
傳回值
可能的傳回值包括,但不限於下列各項。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
ppIFunctionInstanceQuery 為 NULL。 |
|
方法無法配置執行這項作業所需的記憶體。 |
備註
函式探索網路提供者只會透過 IFunctionDiscoveryNotification 介面傳回實例。
這個方法只會初始化查詢呼叫。 必須呼叫 ppIFunctionInstanceQuery 中傳回之 IFunctionInstanceQuery 介面的 Execute 方法,才能執行查詢並傳回任何數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | functiondiscoveryapi.h |
| Dll | FunDisc.dll |