perfDeleteInstance 函式 (perflib.h)

刪除 PerfCreateInstance 函式所建立之計數器集的實例。提供者會使用此函式。

語法

ULONG PerfDeleteInstance(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);

[in] Provider

提供者的句柄。使用 CTRPP 工具為您產生的句柄變數。如需變數的名稱，請參閱提供者專案的符號屬性。

Windows Vista： PerfStartProvider 函式會傳回句柄。

[in] InstanceBlock

包含要刪除之計數器實例的 PERF_COUNTERSET_INSTANCE 結構。

如果函式成功，則會傳回ERROR_SUCCESS。

如果函式失敗，則傳回值是系統錯誤碼。

如果提供者進程異常終止，則會釋放所有配置的實例。

提供者會決定刪除實例的時機。如果計數器數據更靜態，提供者可以在清除時刪除實例。例如，計算機上的處理器數目會被視為靜態，因此提供處理器計數器數據的提供者可以在清除時刪除計算機上每個處理器的實例。對於更動態的計數器，例如磁碟或進程計數器，提供者會刪除實例以回應要移除的USB裝置或正在終止的進程。