pdhValidatePathExW 函数 (pdh.h)
验证指定的计数器是否存在在计算机上或日志文件中。
语法
PDH_FUNCTION PdhValidatePathExW(
[in, optional] PDH_HLOG hDataSource,
[in] LPCWSTR szFullPathBuffer
);
参数
[in, optional] hDataSource
数据源的句柄。 PdhOpenLog 和 PdhBindInputDataSource 函数返回此句柄。
若要验证计数器是否存在于本地计算机上,请指定 NULL (这与调用 PdhValidatePath) 相同。
[in] szFullPathBuffer
以 Null 结尾的字符串,指定要验证的计数器路径。 计数器路径的最大长度为PDH_MAX_COUNTER_PATH。
返回值
如果函数成功,则返回ERROR_SUCCESS。
如果函数失败,则返回值为 系统错误代码 或 PDH 错误代码。 以下是可能的值。
返回代码 | 说明 |
---|---|
|
找不到性能对象的指定实例。 |
|
在性能对象中找不到指定的计数器。 |
|
在计算机或日志文件中找不到指定的性能对象。 |
|
找不到或未连接到指定的计算机。 |
|
无法分析计数器路径字符串。 |
|
函数无法分配所需的临时缓冲区。 |
注解
注意
pdh.h 标头将 PdhValidatePathEx 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | pdh.h |
Library | Pdh.lib |
DLL | Pdh.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈