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-terminated 字符串。

[out] pdwIndex

计数器的索引。

如果函数成功，它将返回ERROR_SUCCESS。

如果函数失败，则返回值为系统错误代码或 PDH 错误代码。下面是一个可能的值。

返回代码	描述
PDH_INVALID_ARGUMENT	参数无效或格式不正确。

注意

pdh.h 标头将 PdhLookupPerfIndexByName 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。