função TSPI_providerInstall (tspi.h)

Artigo
03/03/2024

A função TSPI_providerInstall está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_providerInstall.

A função TSPI_providerInstall instala quaisquer "partes" adicionais do provedor nos diretórios certos (ou pelo menos verificando se eles estão lá), configura as entradas do registro do provedor para suas linhas e telefones e cria quaisquer outras entradas necessárias para o provedor de serviços. Ele é chamado do utilitário de Painel de Controle de telefonia (fornecido com o Windows Telephony nas versões 1.4 e anteriores) quando o botão Adicionar é pressionado.

Sintaxe

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parâmetros

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 possíveis valores retornados são os seguintes:

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM.

Comentários

Essa função conclui a instalação de outras partes exigidas pelo provedor de serviços depois que suas entradas na seção [Provedores] no registro foram feitas. Se o provedor de serviços exigir quaisquer entradas adicionais definidas de forma privada no Registro para a operação adequada, elas também deverão ser instaladas. Uma maneira típica de instalar esta seção com suas entradas é chamar TSPI_providerConfig.

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 é chamada apenas uma vez, durante a instalação do provedor de serviços, até que haja uma chamada para TSPI_providerRemove. Ele deve ser chamado antes de qualquer outra função definida por TSPI.

O utilitário de Painel de Controle de telefonia fornecido com o Windows Telephony nas versões 1.4 e anteriores chama essa função (com requisitos de sequência externos atendidos conforme descrito aqui) quando o comando "add" é invocado. Ele não chama TSPI_providerConfig para o comando "add".

Não há nenhuma função correspondente no nível TAPI. Nesse nível, os aplicativos esperam ter provedores de serviços já instalados. Os aplicativos em execução são informados sobre a reconfiguração dinâmica por meio do valor LINEDEVSTATE_REINIT ou PHONESTATE_REINIT na mensagem LINE_LINEDEVSTATE ou PHONE_STATE.