estructura PDH_COUNTER_INFO_W (pdh.h)
La estructura PDH_COUNTER_INFO contiene información que describe las propiedades de un contador. Esta información también incluye la ruta de acceso del contador.
Sintaxis
typedef struct _PDH_COUNTER_INFO_W {
DWORD dwLength;
DWORD dwType;
DWORD CVersion;
DWORD CStatus;
LONG lScale;
LONG lDefaultScale;
DWORD_PTR dwUserData;
DWORD_PTR dwQueryUserData;
LPWSTR szFullPath;
union {
PDH_DATA_ITEM_PATH_ELEMENTS_W DataItemPath;
PDH_COUNTER_PATH_ELEMENTS_W CounterPath;
struct {
LPWSTR szMachineName;
LPWSTR szObjectName;
LPWSTR szInstanceName;
LPWSTR szParentInstance;
DWORD dwInstanceIndex;
LPWSTR szCounterName;
};
};
LPWSTR szExplainText;
DWORD DataBuffer[1];
} PDH_COUNTER_INFO_W, *PPDH_COUNTER_INFO_W;
Miembros
dwLength
Tamaño de la estructura, incluidas las cadenas anexadas, en bytes.
dwType
Tipo de contador. Para obtener una lista de tipos de contadores, consulta la sección Tipos de contadores del Kit de implementación de Windows Server 2003. Las constantes de tipo de contador se definen en Winperf.h.
CVersion
Información de la versión del contador. No se usa.
CStatus
Estado del contador que indica si el valor del contador es válido. Para obtener una lista de los valores posibles, consulte Comprobación de los valores devueltos de la interfaz PDH.
lScale
Factor de escala que se va a usar al calcular el valor que se puede mostrar del contador. El factor de escala es una potencia de diez. El intervalo válido de este parámetro es PDH_MIN_SCALE (–7) (el valor devuelto es el valor real veces 10–⁷) para PDH_MAX_SCALE (+7) (el valor devuelto es el valor real veces 10⁺⁷). Un valor de cero establecerá la escala en una, de modo que se devuelva el valor real.
lDefaultScale
Factor de escala predeterminado tal y como sugiere el proveedor del contador.
dwUserData
Valor pasado en el parámetro dwUserData al llamar a PdhAddCounter.
dwQueryUserData
Valor pasado en el parámetro dwUserData al llamar a PdhOpenQuery.
szFullPath
Cadena terminada en NULL que especifica la ruta de acceso de contador completa. La cadena sigue esta estructura en memoria.
DataItemPath
Estructura de PDH_DATA_ITEM_PATH_ELEMENTS . No se usa.
CounterPath
Estructura PDH_COUNTER_PATH_ELEMENTS .
szMachineName
Cadena terminada en NULL que contiene el nombre del equipo especificado en la ruta de acceso del contador. Es NULL, si la ruta de acceso no especifica un equipo. La cadena sigue esta estructura en memoria.
szObjectName
Cadena terminada en NULL que contiene el nombre del objeto de rendimiento especificado en la ruta de acceso del contador. La cadena sigue esta estructura en memoria.
szInstanceName
Cadena terminada en NULL que contiene el nombre de la instancia de objeto especificada en la ruta de acceso del contador. Es NULL, si la ruta de acceso no especifica una instancia. La cadena sigue esta estructura en memoria.
szParentInstance
Cadena terminada en NULL que contiene el nombre de la instancia primaria especificada en la ruta de acceso del contador. Es NULL, si la ruta de acceso no especifica una instancia primaria. La cadena sigue esta estructura en memoria.
dwInstanceIndex
Índice de instancia especificado en la ruta de acceso del contador. Es 0, si la ruta de acceso no especifica un índice de instancia.
szCounterName
Cadena terminada en NULL que contiene el nombre del contador. La cadena sigue esta estructura en memoria.
szExplainText
Texto de ayuda que describe el contador. Es NULL si el origen es un archivo de registro.
DataBuffer[1]
Inicio de los datos de cadena que se anexan a la estructura.
Comentarios
Al asignar memoria para esta estructura, asigne suficiente memoria para las cadenas de miembro, como szCounterName, que se anexan al final de esta estructura.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | pdh.h |