Função lineGetProviderListW (tapi.h)

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

Sintaxe

LONG lineGetProviderListW(
  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 de LINEPROVIDERLIST. Antes de chamar lineGetProviderList, o aplicativo deve definir o dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Observação 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 de retorno

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.

Observações

Nota

O cabeçalho tapi.h define lineGetProviderList como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

LINEPROVIDERLIST

Funções de serviço de linha suplementar

visão geral de referência do TAPI 2.2

lineNegotiateAPIVersion