função TUISPI_providerRemove (tspi.h)

Artigo
03/08/2023

A função TUISPI_providerRemove solicita que o usuário confirme a eliminação do provedor de serviços. Essa função torna a função TSPI_providerRemove obsoleta na versão 2.0 e posterior (com suporte na versão 1.4 e anterior).

É responsabilidade do provedor de serviços remover todas as entradas do Registro que o provedor de serviços adicionou no momento addProvider , bem como quaisquer outros módulos e arquivos que não são mais necessários.

A implementação é opcional.

Sintaxe

LONG TSPIAPI TUISPI_providerRemove(
  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 qualquer janela de caixa de diálogo necessária durante a remoção.

dwPermanentProviderID

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

Valor retornado

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 garantir que as informações definidas de qualquer provedor de serviços sejam removidas do registro se retornarem êxito.

Esse procedimento 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 remoção quando ela for parcialmente concluída. Se a remoçã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 remoção completa é possível, antes do início da remoção.

Essa função pode ser chamada enquanto o provedor de serviços está em uso (ou seja, entre TSPI_providerInit e TSPI_providerShutdown). Se isso acontecer, o provedor de serviços deverá fazer uma combinação apropriada de exibir uma caixa de diálogo do usuário para anunciar qualquer conflito e confirmar a remoção, restringindo as opções de remoção para aqueles que podem ser executados de forma transparente ou emitindo mensagens LINE_CLOSE e PHONE_CLOSE para informar ao TAPI e aos aplicativos que os dispositivos afetados foram fechados à força para remoção. De qualquer forma, todas as alterações que afetam o comportamento visível por meio do TSPI devem entrar em vigor somente quando o provedor de serviços for desligado no próximo TSPI_providerShutdown.

Nota Essa função não deve retornar LINEERR_INUSE ou outros erros que possam ocorrer porque o provedor está em uso por um aplicativo; Em vez disso, o provedor deve conferir ao usuário diretamente sobre esse problema e, em seguida, retornar LINEERR_OPERATIONFAILED se o usuário decidir anular a operação.

Esse procedimento é chamado apenas uma vez, no momento da remoção do provedor de serviços, até que haja uma chamada para TUISPI_providerInstall.

A função correspondente no nível TAPI é lineRemoveProvider. Nesse nível, os aplicativos esperam ter provedores de serviços já instalados; caso contrário, suas linhas e telefones não aparecem dentro da sequência disponível de identificadores de dispositivo. A mensagem LINE_CREATE informa os aplicativos que estão em execução sobre reconfiguração dinâmica.