PerfEnumerateCounterSet 函式 (perflib.h)

  • 發行項

取得在 上註冊之計數器集的計數器集標識碼

指定的系統。

計數器集標識碼是全域唯一標識符， (GUID) 。

語法

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

參數

[in, optional] szMachine

要取得計數器集標識碼的計算機名稱。 如果為 NULL，函式會擷取本機計算機的計數器集標識碼。

[out, optional] pCounterSetIds

緩衝區的指標，其有足夠的空間可接收 cCounterSetIds 參數所指定的 GUID 數目。 如果 為 NULL，則為 NULL

cCounterSetIds 為 0。

cCounterSetIds

pCounterSetIds 參數所指定的緩衝區大小，以 GUID 為單位。

[out] pcCounterSetIdsActual

取得計數器集標識碼所需的緩衝區大小。 意義取決於函式的值

返回。

函式傳回值 pcCounterSetIdsActual 的意義
ERROR_SUCCESS 的數目

函式儲存在 pCounterSetIds 指定之緩衝區中的 GUID。
ERROR_NOT_ENOUGH_MEMORY The

需要緩衝區的 GUID) 大小 (。 將緩衝區放大為必要的

重設大小並再次呼叫 函式。
其他 值未定義，不應使用。

傳回值

傳回碼 Description
ERROR_SUCCESS
 函式已成功將所有內容集標識符儲存在 pCounterSetIds 指定的緩衝區中。 pcCounterSetIdsActual 指向的值，指出實際儲存在緩衝區中的計數器集標識符數目。
ERROR_NOT_ENOUGH_MEMORY
 指定的 pCounterSetIds 緩衝區不夠大，無法儲存指定系統上計數器集的所有計數器集標識符。 pcCounterSetIdsActual 指向的值，指出儲存所有計數器集標識碼所需的緩衝區大小。 將緩衝區放大為必要的

重設大小並再次呼叫 函式。
 

針對其他類型的失敗，傳回值是 系統錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1607 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 perflib.h
程式庫 AdvAPI32.lib
Dll AdvAPI32.dll

另請參閱

PerfEnumerateCounterSetInstances