varSTRING 结构 (tapi.h)

VARSTRING 结构用于返回大小可变的字符串。 线路设备类和电话设备类都使用它。

语法

typedef struct varstring_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwStringFormat;
  DWORD dwStringSize;
  DWORD dwStringOffset;
} VARSTRING, *LPVARSTRING;

成员

dwTotalSize

分配给此数据结构的总大小（以字节为单位）。

dwNeededSize

保存所有返回信息所需的此数据结构的大小（以字节为单位）。

dwUsedSize

包含有用信息的此数据结构部分的大小（以字节为单位）。

dwStringFormat

字符串的格式。 此成员使用 STRINGFORMAT_常量之一。

dwStringSize

字符串信息的大小，包括 null 终止符，以字节为单位。

dwStringOffset

从 结构开头到包含字符串信息的可变大小设备字段的偏移量。 字段的大小由 dwStringSize 指定。

注解

无扩展性。

如果无法在变量结构中返回字符串，则按以下方式之一设置 dwStringSize 和 dwStringOffset 成员：

• dwStringSize 和 dwStringOffset 成员都设置为零。
• dwStringOffset 为非零值， dwStringSize 为零。
• dwStringOffset 为非零值， dwStringSize 为 1，给定偏移处的字节为零。

要求

标头	tapi.h