pdhOpenQueryA 函数 (pdh.h)

创建用于管理性能数据收集的新查询。

若要使用数据源的句柄，请使用 PdhOpenQueryH 函数。

语法

PDH_FUNCTION PdhOpenQueryA(
  [in]  LPCSTR     szDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

[in] szDataSource

以 Null 结尾的字符串，指定要从中检索性能数据的日志文件的名称。如果 为 NULL，则从实时数据源收集性能数据。

[in] dwUserData

要与此查询关联的用户定义的值。若要稍后检索用户数据，请调用 PdhGetCounterInfo 并访问 PDH_COUNTER_INFO 的 dwQueryUserData 成员。

[out] phQuery

查询的句柄。在后续调用中使用此句柄。

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

如果函数失败，则返回值为系统错误代码或 PDH 错误代码。

注意

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