estrutura PDH_COUNTER_INFO_A (pdh.h)

A estrutura PDH_COUNTER_INFO contém informações que descrevem as propriedades de um contador. Essas informações também incluem o caminho do contador.

Sintaxe

typedef struct _PDH_COUNTER_INFO_A {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPSTR     szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_A   CounterPath;
    struct {
      LPSTR szMachineName;
      LPSTR szObjectName;
      LPSTR szInstanceName;
      LPSTR szParentInstance;
      DWORD dwInstanceIndex;
      LPSTR szCounterName;
    };
  };
  LPSTR     szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;

Membros

dwLength

Tamanho da estrutura, incluindo as cadeias de caracteres acrescentadas, em bytes.

dwType

Tipo de contador. Para obter uma lista de tipos de contador, consulte a seção Tipos de contador do Kit de Implantação do Windows Server 2003. As constantes de tipo de contador são definidas em Winperf.h.

CVersion

Informações de versão do contador. Não usado.

CStatus

Contador status que indica se o valor do contador é válido. Para obter uma lista de valores possíveis, consulte Verificando valores retornados da interface PDH.

lScale

Fator de escala a ser usado ao calcular o valor exibivel do contador. O fator de escala é uma potência de dez. O intervalo válido desse parâmetro é PDH_MIN_SCALE (–7) (o valor retornado é o valor real vezes 10^–⁷) para PDH_MAX_SCALE (+7) (o valor retornado é o valor real vezes 10⁺⁷). Um valor igual a zero definirá a escala como um, de modo que o valor real seja retornado

lDefaultScale

Fator de escala padrão, conforme sugerido pelo provedor do contador.

dwUserData

O valor passado no parâmetro dwUserData ao chamar PdhAddCounter.

dwQueryUserData

O valor passado no parâmetro dwUserData ao chamar PdhOpenQuery.

szFullPath

Cadeia de caracteres terminada em nulo que especifica o caminho completo do contador. A cadeia de caracteres segue essa estrutura na memória.

DataItemPath

Uma estrutura PDH_DATA_ITEM_PATH_ELEMENTS . Não usado.

CounterPath

Uma estrutura PDH_COUNTER_PATH_ELEMENTS .

szMachineName

Cadeia de caracteres terminada em nulo que contém o nome do computador especificado no caminho do contador. É NULL, se o caminho não especificar um computador. A cadeia de caracteres segue essa estrutura na memória.

szObjectName

Cadeia de caracteres terminada em nulo que contém o nome do objeto de desempenho especificado no caminho do contador. A cadeia de caracteres segue essa estrutura na memória.

szInstanceName

Cadeia de caracteres terminada em nulo que contém o nome da instância de objeto especificada no caminho do contador. É NULL, se o caminho não especificar uma instância. A cadeia de caracteres segue essa estrutura na memória.

szParentInstance

Cadeia de caracteres terminada em nulo que contém o nome da instância pai especificada no caminho do contador. É NULL, se o caminho não especificar uma instância pai. A cadeia de caracteres segue essa estrutura na memória.

dwInstanceIndex

Índice de instância especificado no caminho do contador. Será 0, se o caminho não especificar um índice de instância.

szCounterName

Cadeia de caracteres terminada em nulo que contém o nome do contador. A cadeia de caracteres segue essa estrutura na memória.

szExplainText

Texto da ajuda que descreve o contador. Será NULL se a origem for um arquivo de log.

DataBuffer[1]

Início dos dados de cadeia de caracteres que são acrescentados à estrutura.

Comentários

Ao alocar memória para essa estrutura, aloque memória suficiente para as cadeias de caracteres de membro, como szCounterName, que são acrescentadas ao final dessa estrutura.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	pdh.h

Confira também

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo