通过

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-terminated 字符串，其中包含用户选择的日志文件的名称。 如果缓冲区太小，则日志文件名称将被截断为缓冲区的大小。

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

[in, out] pcchBufferLength

TCHAR中 szDataSource 缓冲区的最大大小。

返回值

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

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

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

言论

注意

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

要求

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

另请参阅

PdhIsRealTimeQuery