Estrutura LINELOCATIONENTRY (tapi.h)
A estrutura LINELOCATIONENTRY descreve um local usado para fornecer um contexto de tradução de endereço. A estrutura LINETRANSLATECAPS pode conter uma matriz de estruturas LINELOCATIONENTRY .
Sintaxe
typedef struct linelocationentry_tag {
DWORD dwPermanentLocationID;
DWORD dwLocationNameSize;
DWORD dwLocationNameOffset;
DWORD dwCountryCode;
DWORD dwCityCodeSize;
DWORD dwCityCodeOffset;
DWORD dwPreferredCardID;
DWORD dwLocalAccessCodeSize;
DWORD dwLocalAccessCodeOffset;
DWORD dwLongDistanceAccessCodeSize;
DWORD dwLongDistanceAccessCodeOffset;
DWORD dwTollPrefixListSize;
DWORD dwTollPrefixListOffset;
DWORD dwCountryID;
DWORD dwOptions;
DWORD dwCancelCallWaitingSize;
DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;
Membros
dwPermanentLocationID
Permanente. Identifica o local.
dwLocationNameSize
Tamanho, em caracteres, de uma cadeia de caracteres de nome de local terminada em nulo, incluindo o caractere de terminação nula.
dwLocationNameOffset
Tamanho do deslocamento, especificado em dwLocationNameSize, desde o início da estrutura LINETRANSLATECAPS (que contém essa entrada) até uma cadeia de caracteres terminada em nulo que descreve o local de maneira amigável ao usuário.
dwCountryCode
Código de país ou região do local.
dwCityCodeSize
Tamanho, em caracteres, da cadeia de caracteres de código da cidade terminada em nulo, incluindo o caractere de terminação nula.
dwCityCodeOffset
Deslocamento, especificado em dwCityCodeSize, desde o início dessa estrutura até uma cadeia de caracteres terminada em nulo especificando o código de cidade/área associado ao local. Essas informações, com o código de país ou região, podem ser usadas por aplicativos para campos de entrada "padrão" para o usuário ao inserir números de telefone, para incentivar a entrada de números canônicos adequados.
dwPreferredCardID
A chamada preferencial cartão ao discar desse local.
dwLocalAccessCodeSize
Tamanho, em bytes, da cadeia de caracteres de código de acesso local, incluindo o terminador nulo .
dwLocalAccessCodeOffset
Tamanho do deslocamento, especificado em dwLocalAccessCodeSize, desde o início da estrutura LINETRANSLATECAPS até uma cadeia de caracteres terminada em nulo que contém o código de acesso a ser discado antes de chamadas para endereços na área de chamada local.
dwLongDistanceAccessCodeSize
Tamanho, em bytes, do código de acesso de longa distância, incluindo o terminador nulo .
dwLongDistanceAccessCodeOffset
Tamanho do deslocamento, especificado em dwLongDistanceAccessCodeSize, desde o início da estrutura LINETRANSLATECAPS até uma cadeia de caracteres terminada em nulo que contém o código de acesso a ser discado antes de chamadas para endereços fora da área de chamada local.
dwTollPrefixListSize
Tamanho, em bytes, do prefixo toll, incluindo o terminador nulo .
dwTollPrefixListOffset
Tamanho do deslocamento, especificado em dwTollPrefixListSize, desde o início da estrutura LINETRANSLATECAPS até uma cadeia de caracteres terminada em nulo que contém a lista de prefixos de pedágio para o local. A cadeia de caracteres contém apenas prefixos que consistem nos dígitos "0" a "9", separados uns dos outros por um único caractere "," (vírgula).
dwCountryID
Identificador do país/região selecionado para o local. Isso pode ser usado com a função lineGetCountry para obter informações adicionais sobre o país/região específico, como o nome do país/região (o membro dwCountryCode não pode ser usado para essa finalidade porque os códigos de país/região não são exclusivos).
dwOptions
Opções em vigor para esse local, com valores obtidos das constantes LINELOCATIONOPTION_.
dwCancelCallWaitingSize
Tamanho, em bytes, da cadeia de caracteres cancel-call-waiting.
dwCancelCallWaitingOffset
Tamanho do deslocamento, especificado em dwCancelCallWaitingSize, desde o início da estrutura LINETRANSLATECAPS até uma cadeia de caracteres terminada em nulo que contém os dígitos de discagem e caracteres modificadores que devem ser prefixados para a cadeia de caracteres discável (após o caractere de pulso/tom) quando um aplicativo define o LINETRANSLATEOPTION_CANCELCALLWAITING bit no parâmetro dwTranslateOptions de lineTranslateAddress. Se nenhum prefixo for definido, dwCancelCallWaitingSize poderá ser definido como zero ou 1, e dwCancelCallWaitingOffset poderá apontar para uma cadeia de caracteres vazia (byte NULL único).
Comentários
Essa estrutura não pode ser estendida.
Os aplicativos mais antigos são compilados sem conhecimento desses novos campos e usam um SIZEOF LINELOCATIONENTRY menor que o novo tamanho. Como essa é uma matriz na parte variável de uma estrutura LINETRANSLATECAPS , é imperativo que os aplicativos mais antigos recebam estruturas LINELOCATIONENTRY no formato esperado anteriormente ou não possam indexar por meio da matriz corretamente. O aplicativo passa um parâmetro dwAPIVersion com a função lineGetTranslateCaps , que pode ser usada para diretrizes do TAPI para lidar com essa situação. A função lineGetTranslateCaps deve usar os membros LINELOCATIONENTRY e o tamanho que correspondem à versão de API indicada ao criar a estrutura LINETRANSLATECAPS a ser retornada ao aplicativo.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | tapi.h |