PdhSelectDataSourceA 函数 (pdh.h)

  • 项目

显示一个对话框窗口，提示用户指定性能数据的源。

语法

PDH_FUNCTION PdhSelectDataSourceA(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPSTR   szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

参数

[in] hWndOwner

对话框窗口的所有者。 如果没有所有者 (桌面成为所有者) ，则这可以为 NULL 。

[in] dwFlags

将显示用于提示输入数据源的对话框。 此参数的取值可为下列值之一：

值 含义
PDH_FLAGS_FILE_BROWSER_ONLY
 仅显示文件浏览器。 仅当想要提示输入日志文件的名称和位置时，请设置此标志。
0
 显示数据源选择对话框。 该对话框允许用户从日志文件或实时源中选择性能数据。 如果用户指定从日志文件收集数据，则会显示一个文件浏览器，供用户指定日志文件的名称和位置。

[out] szDataSource

调用方分配的缓冲区，该缓冲区接收一个 以 null 结尾的字符串，其中包含用户选择的日志文件的名称。 如果缓冲区太小，日志文件名将被截断为缓冲区的大小。

如果用户选择了实时源，则缓冲区为空。

[in, out] pcchBufferLength

szDataSource 缓冲区的最大大小（以 TCHAR 为单位）。

返回值

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

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

返回代码 说明
PDH_INVALID_ARGUMENT
 在 pcchBufferLength 中传递的缓冲区长度不等于 szDataSource 缓冲区的实际长度。
PDH_MEMORY_ALLOCATION_FAILURE
 在 szDataSource 参数中传递了零长度缓冲区。

注解

注意

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

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 pdh.h
Library Pdh.lib
DLL Pdh.dll

另请参阅

PdhIsRealTimeQuery