pdhValidatePathExA 函数 (pdh.h)

验证指定的计数器是否存在于计算机或日志文件中。

语法

PDH_FUNCTION PdhValidatePathExA(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCSTR   szFullPathBuffer
);

[in, optional] hDataSource

数据源的句柄。 PdhOpenLog 和 PdhBindInputDataSource 函数返回此句柄。

若要验证计数器是否在本地计算机上存在，请指定 NULL (这与调用 PdhValidatePath) 相同。

[in] szFullPathBuffer

以 Null 结尾的字符串，指定要验证的计数器路径。计数器路径的最大长度为PDH_MAX_COUNTER_PATH。

如果函数成功，则返回ERROR_SUCCESS。

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

返回代码	说明
PDH_CSTATUS_NO_INSTANCE	找不到性能对象的指定实例。
PDH_CSTATUS_NO_COUNTER	在性能对象中找不到指定的计数器。
PDH_CSTATUS_NO_OBJECT	在计算机或日志文件中找不到指定的性能对象。
PDH_CSTATUS_NO_MACHINE	找不到或无法连接到指定的计算机。
PDH_CSTATUS_BAD_COUNTERNAME	无法分析计数器路径字符串。
PDH_MEMORY_ALLOCATION_FAILURE	函数无法分配所需的临时缓冲区。

注意

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