Estrutura VARSTRING (tapi.h)

A estrutura VARSTRING é usada para retornar cadeias de caracteres de tamanho variável. Ele é usado tanto pela classe de dispositivo de linha quanto pela classe de dispositivo de telefone.

Sintaxe

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

Membros

dwTotalSize

Tamanho total alocado para essa estrutura de dados, em bytes.

dwNeededSize

Tamanho para essa estrutura de dados necessária para armazenar todas as informações retornadas, em bytes.

dwUsedSize

Tamanho da parte dessa estrutura de dados que contém informações úteis, em bytes.

dwStringFormat

Formato da cadeia de caracteres. Esse membro usa uma das constantes STRINGFORMAT_.

dwStringSize

Tamanho das informações da cadeia de caracteres, incluindo o terminador nulo , em bytes.

dwStringOffset

Deslocamento do início da estrutura para o campo de dispositivo de tamanho variável que contém as informações da cadeia de caracteres. O tamanho do campo é especificado por dwStringSize.

Comentários

Sem extensibilidade.

Se uma cadeia de caracteres não puder ser retornada em uma estrutura variável, os membros dwStringSize e dwStringOffset serão definidos de uma das seguintes maneiras:

• Os membros dwStringSize e dwStringOffset são definidos como zero.
• dwStringOffset é diferente de zero e dwStringSize é zero.
• dwStringOffset é diferente de zero, dwStringSize é 1 e o byte no deslocamento fornecido é zero.

Requisitos