PDH_COUNTER_INFO_A結構 (pdh.h)

PDH_COUNTER_INFO 結構包含描述計數器屬性的資訊。 此資訊也包含計數器路徑。

語法

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;

成員

dwLength

結構的大小，包括附加的字串，以位元組為單位。

dwType

計數器類型。 如需計數器類型的清單，請參閱 Windows Server 2003 部署套件的計數器類型一節。 計數器類型常數定義於 Winperf.h 中。

CVersion

計數器版本資訊。 未使用。

CStatus

計數器狀態，指出計數器值是否有效。 如需可能值的清單，請參閱 檢查 PDH 介面傳回值。

lScale

計算計數器的可顯示值時要使用的縮放比例。 縮放比例是十的乘冪。 此參數的有效範圍是 PDH_MIN_SCALE (–7) (傳回的值是實際值為 10^–⁷) PDH_MAX_SCALE (+7) (傳回的值是實際值為 10⁺⁷) 。 值為零會將小數字數設定為 1，以便傳回實際值

lDefaultScale

計數器提供者所建議的預設縮放比例。

dwUserData

呼叫 PdhAddCounter 時，在 dwUserData 參數中傳遞的值。

dwQueryUserData

呼叫 PdhOpenQuery 時，在 dwUserData 參數中傳遞的值。

szFullPath

指定完整計數器路徑的 Null 終止字串。 字串會遵循記憶體中的這個結構。

DataItemPath

PDH_DATA_ITEM_PATH_ELEMENTS結構。 未使用。

CounterPath

PDH_COUNTER_PATH_ELEMENTS結構。

szMachineName

以 Null 結尾的字串，其中包含計數器路徑中指定的電腦名稱。 如果路徑未指定計算機，則為 NULL。 字串會遵循記憶體中的這個結構。

szObjectName

以 Null 結束的字串，其中包含計數器路徑中指定的性能物件名稱。 字串會遵循記憶體中的這個結構。

szInstanceName

以 Null 結束的字串，其中包含計數器路徑中指定的物件實例名稱。 如果路徑未指定實例，則為 NULL。 字串會遵循記憶體中的這個結構。

szParentInstance

以 Null 結束的字串，其中包含計數器路徑中指定的父實例名稱。 如果路徑未指定父實例，則為 NULL。 字串會遵循記憶體中的這個結構。

dwInstanceIndex

計數器路徑中指定的實例索引。 如果路徑未指定實例索引，則為 0。

szCounterName

包含計數器名稱的 Null 終止字串。 字串會遵循記憶體中的這個結構。

szExplainText

描述計數器的說明文字。 如果來源是記錄檔，則為 NULL 。

DataBuffer[1]

附加至 結構的字串數據開頭。

備註

當您配置此結構的記憶體時，請為附加至這個結構結尾的成員字串配置足夠的記憶體，例如 szCounterName。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	pdh.h

另請參閱

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo