Compartir a través de


Función PdhOpenQueryA (pdh.h)

Crea una nueva consulta que se usa para administrar la recopilación de datos de rendimiento.

Para usar identificadores para orígenes de datos, use la función PdhOpenQueryH .

Sintaxis

PDH_FUNCTION PdhOpenQueryA(
  [in]  LPCSTR     szDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

Parámetros

[in] szDataSource

Cadena terminada en NULL que especifica el nombre del archivo de registro del que se van a recuperar los datos de rendimiento. Si es NULL, los datos de rendimiento se recopilan de un origen de datos en tiempo real.

[in] dwUserData

Valor definido por el usuario que se va a asociar a esta consulta. Para recuperar los datos de usuario más adelante, llame a PdhGetCounterInfo y acceda al miembro dwQueryUserData de PDH_COUNTER_INFO.

[out] phQuery

Identificador de la consulta. Este identificador se usa en llamadas posteriores.

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.

Comentarios

Nota:

El encabezado pdh.h define PdhOpenQuery 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

   
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

PdhCloseQuery

PdhGetCounterInfo

PdhIsRealTimeQuery

PdhOpenQueryH

PdhSetDefaultRealTimeDataSource