Compartir a través de

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 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 siguientes valores.

Valor Significado
PDH_FLAGS_FILE_BROWSER_ONLY
 Muestra 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 datos de rendimiento de un archivo de registro o de 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 un cadena terminadanull 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 de szDataSource, en TCHAR.

Valor devuelto

Si la función se ejecuta 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 el pcchBufferLength de no es igual a la longitud real del búfer de szDataSource.
PDH_MEMORY_ALLOCATION_FAILURE
 Se pasó un búfer de longitud cero en el parámetro szDataSource.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de pdh.h
biblioteca de Pdh.lib
DLL de Pdh.dll

Consulte también

PdhIsRealTimeQuery