Поделиться через

Структура 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