TcQueryFlowA 函式 (traffic.h)
TcQueryFlow 函式會根據流程名稱查詢流量控制特定流程參數的值。 流程的名稱可以從 TcEnumerateFlows 函式 或從 tcGetFlowName 函式擷取。
語法
ULONG TcQueryFlowA(
[in] LPSTR pFlowName,
[in] LPGUID pGuidParam,
[in, out] PULONG pBufferSize,
[out] PVOID Buffer
);
參數
[in] pFlowName
正在查詢的流程名稱。
[in] pGuidParam
對應至相關流程參數之全域唯一標識碼 (GUID) 的指標。 您可以在 GUID中找到流量控制 GUID 的清單。
[in, out] pBufferSize
用戶端提供的緩衝區大小或流量控制所使用的位元元組數目指標。 針對輸入,以位元組為單位指向 Buffer的大小。 針對輸出,以位元組為單位,指向以傳回的流程參數數據寫入的實際緩衝區空間數量。
[out] Buffer
用戶端提供的緩衝區指標,其中會寫入傳回的流程參數。
傳回值
傳回碼 | 描述 |
---|---|
|
未發生錯誤的函式執行。 |
|
參數無效。 |
|
提供的緩衝區太小,無法保存結果。 |
|
不支援要求的 GUID。 |
|
裝置未註冊此 GUID。 |
|
找不到實例名稱,可能是因為流程或介面正在關閉。 |
言論
使用 TcQueryFlow 函式需要系統管理許可權。
注意
traffic.h 標頭會將 TcQueryFlow 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | traffic.h |
DLL | Traffic.dll |