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

Consulte también

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo