Función PdhSelectDataSourceA (pdh.h)

  • Artículo

Muestra una ventana de diálogo que solicita al usuario que especifique el origen de los datos de rendimiento.

Sintaxis

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

Parámetros

[in] hWndOwner

Propietario de la ventana del cuadro de diálogo. Esto puede ser NULL si no hay ningún propietario (el escritorio se convierte en el propietario).

[in] dwFlags

Cuadros de diálogo que se mostrarán para solicitar el origen de datos. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
PDH_FLAGS_FILE_BROWSER_ONLY
 Mostrar solo el explorador de archivos. Establezca esta marca cuando desee solicitar solo el nombre y la ubicación de un archivo de registro.
0
 Muestra el cuadro de diálogo de selección del origen de datos. El cuadro de diálogo permite al usuario seleccionar los datos de rendimiento de un archivo de registro o un origen en tiempo real. Si el usuario especificó que los datos se van a recopilar de un archivo de registro, se muestra un explorador de archivos para que el usuario especifique el nombre y la ubicación del archivo de registro.

[out] szDataSource

Búfer asignado por el autor de la llamada que recibe una cadena terminada en null que contiene el nombre de un archivo de registro seleccionado por el usuario. El nombre del archivo de registro se trunca al tamaño del búfer si el búfer es demasiado pequeño.

Si el usuario seleccionó un origen en tiempo real, el búfer está vacío.

[in, out] pcchBufferLength

Tamaño máximo del búfer szDataSource , en TCHAR.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto Descripción
PDH_INVALID_ARGUMENT
 La longitud del búfer pasado en pcchBufferLength no es igual a la longitud real del búfer szDataSource .
PDH_MEMORY_ALLOCATION_FAILURE
 Se pasó un búfer de longitud cero en el parámetro szDataSource .

Comentarios

Nota

El encabezado pdh.h define PdhSelectDataSource como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pdh.h
Library Pdh.lib
Archivo DLL Pdh.dll

Consulte también

PdhIsRealTimeQuery