Função lineGetCountry (tapi.h)

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