Struttura VARSTRING (tapi.h)

La struttura VARSTRING viene utilizzata per restituire stringhe di dimensioni variabili. Viene usato sia dalla classe del dispositivo line che dalla classe del dispositivo telefonico.

Sintassi

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

Members

dwTotalSize

Dimensioni totali allocate a questa struttura di dati, in byte.

dwNeededSize

Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.

dwUsedSize

Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.

dwStringFormat

Formato della stringa. Questo membro usa una delle costanti STRINGFORMAT_.

dwStringSize

Dimensioni delle informazioni sulla stringa, incluso il carattere di terminazione Null , in byte.

dwStringOffset

Offset dall'inizio della struttura al campo dispositivo con dimensioni variabili contenente le informazioni sulla stringa. Le dimensioni del campo sono specificate da dwStringSize.

Commenti

Nessuna estendibilità.

Se non è possibile restituire una stringa in una struttura di variabili, i membri dwStringSize e dwStringOffset vengono impostati in uno dei modi seguenti:

• I membri dwStringSize e dwStringOffset sono entrambi impostati su zero.
• dwStringOffset è diverso da zero e dwStringSize è zero.
• dwStringOffset è diverso da zero, dwStringSize è 1 e il byte in corrispondenza dell'offset specificato è zero.

Requisiti