VARSTRING-Struktur (tapi.h)

Die VARSTRING-Struktur wird verwendet, um Zeichenfolgen mit unterschiedlicher Größe zurückzugeben. Es wird sowohl von der Line-Geräteklasse als auch von der Telefongeräteklasse verwendet.

Syntax

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

Member

dwTotalSize

Gesamtgröße, die dieser Datenstruktur in Bytes zugeordnet ist.

dwNeededSize

Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen enthält, in Bytes.

dwStringFormat

Format der Zeichenfolge. Dieses Element verwendet eine der STRINGFORMAT_ Konstanten.

dwStringSize

Größe der Zeichenfolgeninformationen, einschließlich des NULL-Abschlusszeichens , in Bytes.

dwStringOffset

Offset vom Anfang der Struktur auf das variabel große Gerätefeld, das die Zeichenfolgeninformationen enthält. Die Größe des Felds wird von dwStringSize angegeben.

Hinweise

Keine Erweiterbarkeit.

Wenn eine Zeichenfolge in einer Variablenstruktur nicht zurückgegeben werden kann, werden die Elemente dwStringSize und dwStringOffset auf eine der folgenden Arten festgelegt:

• dwStringSize - und dwStringOffset-Member sind beide auf 0 festgelegt.
• dwStringOffset ist nonzero und dwStringSize ist 0.
• dwStringOffset ist nonzero, dwStringSize ist 1, und das Byte am angegebenen Offset ist 0.

Anforderungen