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 |