Función PdhAddEnglishCounterA (pdh.h)
Agrega el contador independiente del idioma especificado a la consulta.
Sintaxis
PDH_FUNCTION PdhAddEnglishCounterA(
[in] PDH_HQUERY hQuery,
[in] LPCSTR szFullCounterPath,
[in] DWORD_PTR dwUserData,
[out] PDH_HCOUNTER *phCounter
);
Parámetros
[in] hQuery
Controla la consulta a la que quieres agregar el contador. La función
[in] szFullCounterPath
Cadena terminada en NULL que contiene la ruta de acceso del contador. Para obtener más información sobre el formato de una ruta de acceso de contador, vea Especificar una ruta de acceso de contador. La longitud máxima de una ruta de acceso de contador es PDH_MAX_COUNTER_PATH.
[in] dwUserData
Valor definido por el usuario. Este valor forma parte de la información del contador. Para recuperar este valor más adelante, llame a la función PdhGetCounterInfo y acceda al dwQueryUserData miembro de la estructura PDH_COUNTER_INFO.
[out] phCounter
Identificador del contador que se agregó a la consulta. Es posible que tenga que hacer referencia a este identificador en las llamadas posteriores.
Valor devuelto
Devuelve ERROR_SUCCESS si la función se realiza correctamente.
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 |
|---|---|
|
No se pudo analizar ni interpretar la ruta de acceso del contador. |
|
No se puede encontrar el contador especificado en el equipo o en el archivo de registro. |
|
La ruta de acceso del contador está vacía. |
|
La ruta de acceso no contenía un nombre de equipo y la función no pudo recuperar el nombre del equipo local. |
|
No se puede encontrar el objeto especificado en el equipo o en el archivo de registro. |
|
No se puede determinar la función de cálculo que se va a usar para este contador. |
|
Uno o varios argumentos no son válidos. |
|
El identificador de consulta no es válido. |
|
No se puede asignar memoria necesaria para completar la función. |
Observaciones
Esta función proporciona una manera independiente del lenguaje para agregar contadores de rendimiento a la consulta. En cambio, la ruta de acceso del contador que especifique en el función PdhAddCounter debe localizarse.
Si se especifica una instancia de contador que aún no existe, PdhAddEnglishCounter no notifica una condición de error. En su lugar, devuelve ERROR_SUCCESS. El motivo de este comportamiento es que no se sabe si se ha especificado una instancia de contador no existente o si existe pero aún no se ha creado.
Para quitar el contador de la consulta, use la función
- Realización de una consulta
- Use PdhAddEnglishCounter con la cadena que contiene caracteres comodín
- Use PdhGetCounterInfo en el identificador de contador devuelto por PdhAddEnglishCounter para obtener una ruta de acceso completa localizada (szFullPath). Esta cadena todavía contiene caracteres comodín, pero las partes que no son comodín ahora están localizadas.
- Use PdhExpandWildCardPath para expandir los caracteres comodín.
- Use PdhAddCounter en cada una de las rutas de acceso resultantes
Nota
El encabezado pdh.h define PdhAddEnglishCounter 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 Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
pdh.h |
| biblioteca de |
Pdh.lib |
| DLL de |
Pdh.dll |