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 nullque especifica el nombre del archivo de registro del que se van a recuperar los datos de rendimiento. Si 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 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 .

Observaciones

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 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

PdhCloseQuery

PdhGetCounterInfo

PdhIsRealTimeQuery

PdhOpenQueryH

PdhSetDefaultRealTimeDataSource