Estructura VARSTRING (tapi.h)

La estructura VARSTRING se usa para devolver cadenas de tamaño variable. Lo usa la clase de dispositivo de línea y la clase de dispositivo telefónico.

Sintaxis

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

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes.

dwNeededSize

Tamaño de esta estructura de datos necesaria para contener toda la información devuelta, en bytes.

dwUsedSize

Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.

dwStringFormat

Formato de la cadena. Este miembro usa una de las STRINGFORMAT_ constantes.

dwStringSize

Tamaño de la información de cadena, incluido el terminador NULL , en bytes.

dwStringOffset

Desplazamiento desde el principio de la estructura hasta el campo de dispositivo de tamaño variable que contiene la información de cadena. DwStringSize especifica el tamaño del campo.

Comentarios

No hay extensibilidad.

Si no se puede devolver una cadena en una estructura de variable, los miembros dwStringSize y dwStringOffset se establecen de una de las maneras siguientes:

• los miembros dwStringSize y dwStringOffset se establecen en cero.
• dwStringOffset es distinto de cero y dwStringSize es cero.
• dwStringOffset es distinto de cero, dwStringSize es 1 y el byte en el desplazamiento especificado es cero.

Requisitos

Encabezado	tapi.h