Estrutura LINETRANSLATEOUTPUT (tapi.h)

Artigo
08/26/2023

A estrutura LINETRANSLATEOUTPUT descreve o resultado de uma tradução de endereço. A função lineTranslateAddress usa essa estrutura.

Sintaxe

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

Membros

dwTotalSize

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

dwNeededSize

Tamanho necessário para que essa estrutura de dados mantenha todas as informações retornadas, em bytes.

dwUsedSize

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

dwDialableStringSize

Tamanho da cadeia de caracteres discável, em bytes, incluindo o NULL de terminação.

dwDialableStringOffset

Deslocamento do início dessa estrutura para a saída traduzida que pode ser passada para a linhaMakeCall, lineDial ou outra função que exige uma cadeia de caracteres discável. A saída é sempre uma cadeia de caracteres terminada em nulo. Campos auxiliares, como nome e subaddress, serão incluídos nessa cadeia de caracteres de saída se estiverem na cadeia de caracteres de entrada. Essa cadeia de caracteres pode conter informações privadas, como chamar cartão números. Ele não deve ser exibido para o usuário, para evitar visibilidade inadvertida para pessoas não autorizadas. O tamanho do campo é especificado por dwDialableStringSize.

dwDisplayableStringSize

Tamanho da saída traduzida que pode ser exibida para o usuário, incluindo o terminador nulo , em bytes.

dwDisplayableStringOffset

Deslocamento para a saída traduzida que pode ser exibida para o usuário para confirmação. Ela é idêntica a DialableString, exceto que os dígitos de cartão de chamada são substituídos pelo nome amigável do cartão entre caracteres entre colchetes (por exemplo, "[AT&T Card]"), e campos auxiliares como nome e subaddress são removidos. Use uma mensagem apropriada em dwDisplayableStringOffset, pois a cadeia de caracteres pode ser exibida publicamente na caixa de diálogo call-status. Essas informações também são apropriadas para incluir em logs de chamadas. O tamanho do campo é especificado por dwDisplayableStringSize.

dwCurrentCountry

Código de país ou região configurado em CurrentLocation. Esse valor pode ser usado para controlar a exibição pelo aplicativo de determinados elementos de interface do usuário, para detecção de tom de progresso de chamada local e para outras finalidades.

dwDestCountry

Código de país/região de destino do endereço traduzido. Esse valor pode ser passado para o parâmetro dwCountryCode de lineMakeCall e outras funções de discagem (de modo que os tons de progresso da chamada do país/região de destino, como um sinal ocupado, sejam detectados corretamente). Esse campo será definido como zero se o endereço de destino passado para lineTranslateAddress não estiver em formato canônico.

dwTranslateResults

Informações derivadas do processo de tradução, que podem ajudar o aplicativo a apresentar elementos de interface do usuário. Esse campo usa uma das constantes LINETRANSLATERESULT_.