Edit

Share via

PdhSelectDataSourceA function (pdh.h)

  • Article

Displays a dialog window that prompts the user to specify the source of the performance data.

Syntax

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

Parameters

[in] hWndOwner

Owner of the dialog window. This can be NULL if there is no owner (the desktop becomes the owner).

[in] dwFlags

Dialog boxes that will be displayed to prompt for the data source. This parameter can be one of the following values.

Value Meaning
PDH_FLAGS_FILE_BROWSER_ONLY
 Display the file browser only. Set this flag when you want to prompt for the name and location of a log file only.
0
 Display the data source selection dialog box. The dialog box lets the user select performance data from either a log file or a real-time source. If the user specified that data is to be collected from a log file, a file browser is displayed for the user to specify the name and location of the log file.

[out] szDataSource

Caller-allocated buffer that receives a null-terminated string that contains the name of a log file that the user selected. The log file name is truncated to the size of the buffer if the buffer is too small.

If the user selected a real time source, the buffer is empty.

[in, out] pcchBufferLength

Maximum size of the szDataSource buffer, in TCHARs.

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, the return value is a system error code or a PDH error code. The following are possible values.

Return code Description
PDH_INVALID_ARGUMENT
 The length of the buffer passed in the pcchBufferLength is not equal to the actual length of the szDataSource buffer.
PDH_MEMORY_ALLOCATION_FAILURE
 A zero-length buffer was passed in the szDataSource parameter.

Remarks

Note

The pdh.h header defines PdhSelectDataSource as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header pdh.h
Library Pdh.lib
DLL Pdh.dll

See also

PdhIsRealTimeQuery