Função lineAddProvider (tapi.h)

Artigo
08/26/2023

A função lineAddProvider instala um novo provedor de serviços de telefonia no sistema de telefonia.

Sintaxe

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

Parâmetros

lpszProviderFilename

Ponteiro para um

cadeia de caracteres terminada em nulo que contém o caminho do provedor de serviços a ser adicionado.

hwndOwner

Manipule para uma janela na qual todas as caixas de diálogo que precisam ser exibidas como parte do processo de instalação (por exemplo, pela função TSPI_providerInstall do provedor de serviços) seriam anexadas. Pode ser NULL para indicar que qualquer janela criada durante a função não deve ter nenhuma janela de proprietário.

lpdwPermanentProviderID

Ponteiro para uma variável que recebe o identificador de provedor permanente do provedor de serviços recém-instalado.

Retornar valor

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_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_OPERATIONFAILED.

Comentários

Durante essa chamada de função, o TAPI verifica se ele pode acessar o provedor de serviços chamando sua função TSPI_providerInstall ; se isso não for bem-sucedido (se a DLL ou a função não puder ser encontrada ou se TSPI_providerInstall retornar um erro), a função falhará e o provedor não será adicionado ao sistema de telefonia. Se isso for bem-sucedido e o sistema de telefonia estiver ativo (um ou mais aplicativos chamaram lineInitialize ou lineInitializeEx), o TAPI não tentará iniciar o provedor de serviços recém-adicionado. Em vez disso, para ativar o novo provedor de serviços, o TAPI emite uma mensagem para reiniciar o Windows. Quando a ativação é bem-sucedida, os aplicativos são informados de todos os novos dispositivos criados por meio de mensagens de LINE_CREATE ou PHONE_CREATE ou por uma mensagem LINE_LINEDEVSTATE solicitando reinicialização (se o aplicativo não der suporte às mensagens CREATE).

Essa função não copia nenhum arquivo , não a própria DLL do provedor de serviços nem os arquivos de suporte; o aplicativo que gerencia a adição do provedor deve garantir que o provedor esteja instalado em um diretório em que ele possa ser encontrado pelo TAPI (por exemplo, \WINDOWS, \WINDOWS\SYSTEM ou em outro lugar no caminho).