struttura PDH_COUNTER_INFO_A (pdh.h)

Articolo
03/08/2023

La struttura PDH_COUNTER_INFO contiene informazioni che descrivono le proprietà di un contatore. Queste informazioni includono anche il percorso del contatore.

Sintassi

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;

Members

dwLength

Dimensioni della struttura, incluse le stringhe aggiunte, in byte.

dwType

Tipo di contatore. Per un elenco dei tipi di contatori, vedere la sezione Tipi di contatore di Windows Server 2003 Deployment Kit. Le costanti del tipo di contatore sono definite in Winperf.h.

CVersion

Informazioni sulla versione del contatore. Non usato.

CStatus

Stato del contatore che indica se il valore del contatore è valido. Per un elenco dei valori possibili, vedere Controllo dei valori restituiti dell'interfaccia PDH.

lScale

Fattore di scala da usare per calcolare il valore visualizzabile del contatore. Il fattore di scala è una potenza di dieci. L'intervallo valido di questo parametro è PDH_MIN_SCALE (–7) (il valore restituito è il valore effettivo di 10^-⁷) per PDH_MAX_SCALE (+7) (il valore restituito è il valore effettivo di 10⁺⁷). Il valore zero imposterà la scala su uno, in modo che venga restituito il valore effettivo

lDefaultScale

Fattore di scala predefinito suggerito dal provider del contatore.

dwUserData

Valore passato nel parametro dwUserData quando si chiama PdhAddCounter.

dwQueryUserData

Valore passato nel parametro dwUserData quando si chiama PdhOpenQuery.

szFullPath

Stringa con terminazione Null che specifica il percorso del contatore completo. La stringa segue questa struttura in memoria.

DataItemPath

Struttura PDH_DATA_ITEM_PATH_ELEMENTS . Non usato.

CounterPath

Struttura PDH_COUNTER_PATH_ELEMENTS .

szMachineName

Stringa con terminazione Null contenente il nome del computer specificato nel percorso del contatore. È NULL, se il percorso non specifica un computer. La stringa segue questa struttura in memoria.

szObjectName

Stringa con terminazione Null contenente il nome dell'oggetto prestazioni specificato nel percorso del contatore. La stringa segue questa struttura in memoria.

szInstanceName

Stringa con terminazione Null contenente il nome dell'istanza dell'oggetto specificata nel percorso del contatore. È NULL, se il percorso non specifica un'istanza. La stringa segue questa struttura in memoria.

szParentInstance

Stringa con terminazione Null contenente il nome dell'istanza padre specificata nel percorso del contatore. È NULL, se il percorso non specifica un'istanza padre. La stringa segue questa struttura in memoria.

dwInstanceIndex

Indice dell'istanza specificato nel percorso del contatore. È 0, se il percorso non specifica un indice di istanza.

szCounterName

Stringa con terminazione Null contenente il nome del contatore. La stringa segue questa struttura in memoria.

szExplainText

Testo della Guida che descrive il contatore. È NULL se l'origine è un file di log.

DataBuffer[1]

Inizio dei dati stringa accodati alla struttura.

Commenti

Quando si alloca memoria per questa struttura, allocare memoria sufficiente per le stringhe membro, ad esempio szCounterName, aggiunte alla fine di questa struttura.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	pdh.h

Vedi anche

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo

Condividi tramite