共用方式為

PerfQueryCounterSetRegistrationInfo 函式 (perflib.h)

  • 發行項

取得指定系統上設定之計數器的相關資訊。

語法

ULONG PerfQueryCounterSetRegistrationInfo(
  [in, optional]  LPCWSTR         szMachine,
  [in]            LPCGUID         pCounterSetId,
                  PerfRegInfoType requestCode,
                  DWORD           requestLangId,
  [out, optional] LPBYTE          pbRegInfo,
                  DWORD           cbRegInfo,
  [out]           LPDWORD         pcbRegInfoActual
);

參數

[in, optional] szMachine

要取得 pCounterSet 參數所指定計數器集相關資訊的電腦名稱稱。 如果為 Null，函式會擷取本機電腦所指定計數器集的相關資訊。

[in] pCounterSetId

要取得資訊之計數器集的計數器集識別碼。

requestCode

您想要取得計數器集合的相關資訊類型。 如需可能值的清單，請參閱 PerfRegInfoType 。

requestLangId

如果 requestCode是PERF_REG_COUNTERSET_NAME_STRING，則為包含所要求資訊的字串慣用地區設定識別碼，

PERF_REG_COUNTERSET_HELP_STRING、 PERF_REG_COUNTER_NAME_STRINGS或

PERF_REG_COUNTER_HELP_STRINGS。

如果 requestCode是PERF_REG_COUNTER_STRUCT，則為您想要資料的計數器計數器識別碼。

針對 requestCode的其他所有值，設定為 0。

[out, optional] pbRegInfo

緩衝區的指標，足以接收 cbRegInfo 參數所指定的資料量，以位元組為單位。 可能

如果 cbRegInfo 為 0，則為 Null。

cbRegInfo

pbRegInfo參數所指定的緩衝區大小，以位元組為單位。

[out] pcbRegInfoActual

取得計數器集合相關資訊所需的緩衝區大小。 意義取決於函式的值

返回。

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

指定計數器集的相關資訊位元組，該計數器集是函式儲存在 pbRegInfo 指定的緩衝區中。
ERROR_NOT_ENOUGH_MEMORY 此

儲存指定電腦上計數器的相關資訊所需的緩衝區大小，以位元組為單位。 將緩衝區放大為所需的

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

傳回值

傳回碼 描述
ERROR_SUCCESS
 函式已成功儲存 pbRegInfo 所指定緩衝區中有關計數器集的所有資訊。 以位元組為單位，指出實際儲存在緩衝區中的資訊量， 以 位元組為單位。
ERROR_NOT_ENOUGH_MEMORY
 pbRegInfo指定的緩衝區不夠大，無法儲存計數器集的所有資訊。 其值會指出儲存所有資訊所需的緩衝區大小。 將緩衝區放大為所需的

大小並再次呼叫 函式。
 

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

備註

如需您可以要求和的資料類型，請參閱PerfRegInfoType

針對每種要求類型提供的資料格式。

需求

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