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
计算计数器的可显示值时要使用的比例系数。 比例系数为 10 的幂。 此参数的有效范围为 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 |