PerfSetULongCounterValue 函式 (perflib.h)
匯報 值為 4 位元組無符號整數的計數器值。 提供者會使用此函式。
語法
ULONG PerfSetULongCounterValue(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE Instance,
[in] ULONG CounterId,
[in] ULONG Value
);
參數
[in] Provider
提供者的句柄。 使用 CTRPP 工具為您產生的句柄變數。 如需變數的名稱，請參閱提供者專案的符號屬性。
Windows Vista： PerfStartProvider 函式會傳回句柄。
[in] Instance
包含計數器集實例 的 PERF_COUNTERSET_INSTANCE 結構。 PerfCreateInstance 函式會傳回此指標。
[in] CounterId
可唯一識別實例區塊中更新之計數器的標識碼。 標識元定義於counter元素的id屬性中，而且必須符合實例區塊中其中一個PERF_COUNTER_INFO結構的CounterId成員。 使用 CTRPP 工具為您產生的計數器識別碼常數。 如需常數的名稱，請參閱計數器專案的符號屬性。
Windows Vista： 計數器標識碼常數無法使用。
[in] Value
新的 4 位元組計數器值。
傳回值
如果函式成功，它會傳回ERROR_SUCCESS。
如果函式失敗，則傳回值是 系統錯誤碼。
備註
這是設定原始計數器數據的便利函式。 若要自行更新原始計數器數據，請使用 PERF_COUNTER_INFO 結構的 Offset 成員來存取特定計數器的原始計數器數據。 PERF_COUNTERSET_INSTANCE 結構區塊包含一或多個計數器信息結構。
您可以使用 PerfIncrementULongCounterValue 和 PerfDecrementULongCounterValue 函式分別遞增或遞減計數器值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | perflib.h |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |
另請參閱
PerfDecrementULongCounterValue