共用方式為


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

用戶端提供的緩衝區指標,其中會寫入傳回的流程參數。

傳回值

傳回碼 描述
NO_ERROR
未發生錯誤的函式執行。
ERROR_INVALID_PARAMETER
參數無效。
ERROR_INSUFFICIENT_BUFFER
提供的緩衝區太小,無法保存結果。
ERROR_NOT_SUPPORTED
不支援要求的 GUID。
ERROR_WMI_GUID_NOT_FOUND
裝置未註冊此 GUID。
ERROR_WMI_INSTANCE_NOT_FOUND
找不到實例名稱,可能是因為流程或介面正在關閉。

言論

使用 TcQueryFlow 函式需要系統管理許可權。

注意

traffic.h 標頭會將 TcQueryFlow 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 traffic.h
DLL Traffic.dll

另請參閱

GUID

TcEnumerateFlows

TcGetFlowName