struktur PDH_COUNTER_INFO_A (pdh.h)

Struktur PDH_COUNTER_INFO berisi informasi yang menjelaskan properti penghitung. Informasi ini juga mencakup jalur penghitung.

Sintaks

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;

Anggota

dwLength

Ukuran struktur, termasuk string yang ditambahkan, dalam byte.

dwType

Jenis penghitung. Untuk daftar jenis penghitung, lihat bagian Jenis Penghitung dari Kit Penyebaran Windows Server 2003. Konstanta jenis penghitung didefinisikan dalam Winperf.h.

CVersion

Informasi versi penghitung. Tidak digunakan.

CStatus

Status penghitung yang menunjukkan apakah nilai penghitung valid. Untuk daftar nilai yang mungkin, lihat Memeriksa Nilai Pengembalian Antarmuka PDH.

lScale

Faktor skala yang akan digunakan saat menghitung nilai penghitung yang dapat ditampilkan. Faktor skala adalah kekuatan sepuluh. Rentang yang valid dari parameter ini adalah PDH_MIN_SCALE (–7) (nilai yang dikembalikan adalah nilai aktual kali 10^–⁷) hingga PDH_MAX_SCALE (+7) (nilai yang dikembalikan adalah nilai aktual kali 10⁺⁷). Nilai nol akan mengatur skala ke satu, sehingga nilai aktual dikembalikan

lDefaultScale

Faktor skala default seperti yang disarankan oleh penyedia penghitung.

dwUserData

Nilai yang diteruskan dalam parameter dwUserData saat memanggil PdhAddCounter.

dwQueryUserData

Nilai yang diteruskan dalam parameter dwUserData saat memanggil PdhOpenQuery.

szFullPath

String yang dihentikan null yang menentukan jalur penghitung penuh. String mengikuti struktur ini dalam memori.

DataItemPath

Struktur PDH_DATA_ITEM_PATH_ELEMENTS . Tidak digunakan.

CounterPath

Struktur PDH_COUNTER_PATH_ELEMENTS .

szMachineName

String yang dihentikan null yang berisi nama komputer yang ditentukan di jalur penghitung. Adalah NULL, jika jalur tidak menentukan komputer. String mengikuti struktur ini dalam memori.

szObjectName

String yang dihentikan null yang berisi nama objek performa yang ditentukan di jalur penghitung. String mengikuti struktur ini dalam memori.

szInstanceName

String yang dihentikan null yang berisi nama instans objek yang ditentukan di jalur penghitung. Adalah NULL, jika jalur tidak menentukan instans. String mengikuti struktur ini dalam memori.

szParentInstance

String yang dihentikan null yang berisi nama instans induk yang ditentukan di jalur penghitung. Adalah NULL, jika jalur tidak menentukan instans induk. String mengikuti struktur ini dalam memori.

dwInstanceIndex

Indeks instans yang ditentukan di jalur penghitung. Adalah 0, jika jalur tidak menentukan indeks instans.

szCounterName

String yang dihentikan null yang berisi nama penghitung. String mengikuti struktur ini dalam memori.

szExplainText

Teks bantuan yang menjelaskan penghitung. Adalah NULL jika sumbernya adalah file log.

DataBuffer[1]

Mulai data string yang ditambahkan ke struktur.

Keterangan

Saat Anda mengalokasikan memori untuk struktur ini, alokasikan memori yang cukup untuk string anggota, seperti szCounterName, yang ditambahkan ke akhir struktur ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	pdh.h

Lihat juga

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo