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 |