Structure VARSTRING (tapi.h)

  • Article

La structure VARSTRING est utilisée pour retourner des chaînes de taille variable. Il est utilisé à la fois par la classe d’appareil de ligne et la classe d’appareil téléphonique.

Syntaxe

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

Membres

dwTotalSize

Taille totale allouée à cette structure de données, en octets.

dwNeededSize

Taille de cette structure de données nécessaire pour contenir toutes les informations retournées, en octets.

dwUsedSize

Taille de la partie de cette structure de données qui contient des informations utiles, en octets.

dwStringFormat

Format de la chaîne. Ce membre utilise l’une des constantes STRINGFORMAT_.

dwStringSize

Taille des informations de chaîne, y compris la fin null , en octets.

dwStringOffset

Décalage du début de la structure vers le champ d’appareil de taille variable contenant les informations de chaîne. La taille du champ est spécifiée par dwStringSize.

Remarques

Aucune extensibilité.

Si une chaîne ne peut pas être retournée dans une structure de variable, les membres dwStringSize et dwStringOffset sont définis de l’une des manières suivantes :

  • Les membres dwStringSize et dwStringOffset sont tous deux définis sur zéro.
  • dwStringOffset est différent de zéro et dwStringSize est égal à zéro.
  • dwStringOffset est différent de zéro, dwStringSize est égal à 1 et l’octet au décalage donné est égal à zéro.

Configuration requise

   
En-tête tapi.h