função TUISPI_providerInstall (tspi.h)

Artigo
08/26/2023

A implementação da função TUISPI_providerInstall é a oportunidade do provedor de serviços de instalar quaisquer "partes" adicionais do provedor nos diretórios corretos (ou pelo menos verificar se eles estão lá) e configurar as entradas do Registro de que o provedor precisa. Essa função torna a função TSPI_providerInstall obsoleta na versão 2.0 e posterior (com suporte na versão 1.4 e anterior).

Se o provedor de serviços exigir entradas definidas de forma privada no Registro para a operação adequada, elas deverão ser instaladas no momento.

A implementação é opcional.

Sintaxe

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Parâmetros

lpfnUIDLLCallback

Ponteiro para uma função que a DLL da interface do usuário pode chamar para se comunicar com a DLL do provedor de serviços para obter as informações necessárias para exibir a caixa de diálogo.

hwndOwner

O identificador da janela pai na qual a função pode criar janelas de caixa de diálogo necessárias durante a instalação.

dwPermanentProviderID

O identificador de provedor permanente do provedor de serviços.

Retornar valor

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

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM. LINEERR_INVALPARAM.

Comentários

Essa função deve deixar o sistema em um estado consistente. Ele deve ser executado até a conclusão, não permitindo que o usuário anule a instalação quando ela for parcialmente concluída. Se a instalação falhar, é responsabilidade do provedor "recuar" o que foi feito e retornar um erro. Isso pode implicar a pré-verificação para verificar se uma instalação completa é possível antes do início da instalação.

Essa função pode ser invocada mais de uma vez durante a instalação do provedor de serviços até que haja uma chamada para TUISPI_providerRemove. No entanto, se o provedor de serviços não exigir ou oferecer suporte a várias instâncias do provedor, ele retornará o LINEERR_ constante LINEERR_NOMULTIPLEINSTANCE.

A função correspondente no nível TAPI é lineAddProvider. A mensagem LINE_CREATE informa os aplicativos que estão em execução sobre reconfiguração dinâmica.