PDH_COUNTER_INFO_W 結構 (pdh.h)
PDH_COUNTER_INFO 結構包含描述計數器屬性的資訊。 此資訊也包含計數器路徑。
語法
typedef struct _PDH_COUNTER_INFO_W {
DWORD dwLength;
DWORD dwType;
DWORD CVersion;
DWORD CStatus;
LONG lScale;
LONG lDefaultScale;
DWORD_PTR dwUserData;
DWORD_PTR dwQueryUserData;
LPWSTR szFullPath;
union {
PDH_DATA_ITEM_PATH_ELEMENTS_W DataItemPath;
PDH_COUNTER_PATH_ELEMENTS_W CounterPath;
struct {
LPWSTR szMachineName;
LPWSTR szObjectName;
LPWSTR szInstanceName;
LPWSTR szParentInstance;
DWORD dwInstanceIndex;
LPWSTR szCounterName;
};
};
LPWSTR szExplainText;
DWORD DataBuffer[1];
} PDH_COUNTER_INFO_W, *PPDH_COUNTER_INFO_W;
成員
dwLength
結構的大小，包括附加的字串，以位元組為單位。
dwType
計數器類型。 如需計數器類型的清單，請參閱 Windows Server 2003 部署套件的計數器類型一節。 計數器類型常數定義於 Winperf.h 中。
CVersion
計數器版本資訊。 未使用。
CStatus
計數器狀態，指出計數器值是否有效。 如需可能值的清單，請參閱 檢查 PDH 介面傳回值。
lScale
計算計數器的可顯示值時要使用的縮放比例。 縮放比例是10的乘冪。 此參數的有效範圍是PDH_MIN_SCALE (–7) (傳回的值是實際值 10–⁷) PDH_MAX_SCALE (+7) (傳回的值是實際值 10⁺⁷) 。 值為零會將小數字數設定為一，以便傳回實際值
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 |