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
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 |