關閉指定查詢中包含的所有計數器、關閉與查詢相關的所有句柄,並釋放與查詢相關聯的所有記憶體。
語法
PDH_FUNCTION PdhCloseQuery(
[in] PDH_HQUERY hQuery
);
參數
[in] hQuery
要關閉之查詢的句柄。 PdhOpenQuery 函式會傳回此句柄。
傳回值
如果函式成功,則會傳回ERROR_SUCCESS。 否則,函式會傳回 系統錯誤碼 或 PDH 錯誤碼。
以下是可能的值。
| 傳回碼 | Description |
|---|---|
|
查詢句柄無效。 |
備註
呼叫此函式之後,請勿使用與此查詢相關聯的計數器句柄。
下列顯示從 Visual Basic 呼叫此函式時語法。
PdhCloseQuery(
ByVal QueryHandle as Long
)
as Long
範例
如需範例,請參閱 流覽性能計數器 或 從記錄檔讀取效能數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | pdh.h |
| 程式庫 | Pdh.lib |
| Dll | Pdh.dll |