PdhLookupPerfIndexByNameA 函式（pdh.h）

傳回對應至指定計數器名稱的計數器索引。

語法

PDH_FUNCTION PdhLookupPerfIndexByNameA(
  [in]  LPCSTR  szMachineName,
  [in]  LPCSTR  szNameBuffer,
  [out] LPDWORD pdwIndex
);

[in] szMachineName

Null-terminated 字串，指定指定計數器所在計算機的名稱。計算機名稱可由 DNS 名稱或 IP 位址指定。如果 NULL，則函式會使用本機電腦。

[in] szNameBuffer

包含計數器名稱的 Null終止字串。

[out] pdwIndex

計數器的索引。

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

如果函式失敗，傳回值是系統錯誤碼或 PDH 錯誤碼。以下是可能的值。

傳回碼	描述
PDH_INVALID_ARGUMENT	參數無效或格式不正確。

注意

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