Función PdhOpenQueryW (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 PdhOpenQueryW(
  [in]  LPCWSTR    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

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

PdhCloseQuery

PdhGetCounterInfo

PdhIsRealTimeQuery

PdhOpenQueryH

PdhSetDefaultRealTimeDataSource