VARSTRING (Windows Embedded CE 6.0)

1/6/2010

This structure is used for returning variably sized strings. It is used both by the line device class and the phone device class.

Syntax

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

Members

• dwTotalSize
  Total size, in bytes, allocated to this data structure.

• dwNeededSize
  Size, in bytes, for this data structure that is needed to hold all the returned data.

• dwUsedSize
  Size, in bytes, of the portion of this data structure that contains useful data.

• dwStringFormat
  Value that specifies the format of the string. This member uses STRINGFORMAT.

• dwStringSize
  Size, in bytes, of the variably sized device field that contains the string data.

• dwStringOffset
  Offset, in bytes, from the beginning of this data structure.

Remarks

No extensibility.

If a string cannot be returned in a variable structure, the dwStringSize and dwStringOffset members are set in one of these ways:

• dwStringSize and dwStringOffset members are both set to zero.
• dwStringOffset is nonzero and dwStringSize is zero.
• dwStringOffset is nonzero, dwStringSize is 1, and the byte at the given offset is zero.

Requirements

See Also

Reference

TAPI Structures
lineConfigDialogEdit
lineGetDevConfig
lineGetID
lineSetDevConfig
LINECALLPARAMS