Função lineGetCountry (tapi.h)

Artigo
03/05/2024

A função lineGetCountry busca as regras de discagem armazenadas e outras informações relacionadas a um país/região especificado, o primeiro país/região na lista de país/região ou todos os países/regiões.

Sintaxe

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Parâmetros

dwCountryID

Identificador de país/região (não o código do país) do país/região para o qual as informações devem ser obtidas. Se o valor 1 for especificado, as informações sobre o primeiro país/região na lista de país/região serão obtidas. Se o valor 0 for especificado, informações sobre todos os países/regiões serão obtidas (o que pode exigir muita memória — 20 KB ou mais).

dwAPIVersion

Versão mais alta do TAPI compatível com o aplicativo (não necessariamente o valor negociado por lineNegotiateAPIVersion em algum dispositivo de linha específico).

lpLineCountryList

Ponteiro para um local para o qual uma estrutura LINECOUNTRYLIST é carregada. Antes de chamar lineGetCountry, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Nota Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico de alocação de memória .

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi.h
Biblioteca	Tapi32.lib
DLL	Tapi32.dll

Confira também

Referência básica dos Serviços de Telefonia

LINECOUNTRYLIST

Visão geral da referência do TAPI 2.2

Linenegotiateapiversion

Compartilhar via