Função lineGetProviderList (tapi.h)

A função lineGetProviderList retorna uma lista de provedores de serviços atualmente instalados no sistema de telefonia.

Sintaxe

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

Parâmetros

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).

lpProviderList

Ponteiro para um local de memória em que TAPI pode retornar uma estrutura LINEPROVIDERLIST . Antes de chamar lineGetProviderList, 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 alocação de memória .

 

Valor retornado

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

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

Requisitos

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

Confira também

LINEPROVIDERLIST

Funções de serviço de linha suplementar

Visão geral da referência do TAPI 2.2

Linenegotiateapiversion