Função lineRemoveProvider (tapi.h)
A função lineRemoveProvider remove um provedor de serviços de telefonia existente do sistema de telefonia.
Sintaxe
LONG lineRemoveProvider(
DWORD dwPermanentProviderID,
HWND hwndOwner
);
Parâmetros
dwPermanentProviderID
Identificador de provedor permanente do provedor de serviços a ser removido.
hwndOwner
Manipule para uma janela à qual as caixas de diálogo que precisam ser exibidas como parte do processo de remoção (por exemplo, uma caixa de diálogo de confirmação pela função TSPI_providerRemove do provedor de serviços) seriam anexadas. Pode ser um valor NULL para indicar que qualquer janela criada durante a função não deve ter nenhuma janela de proprietário.
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_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.
Comentários
Se a chamada para TSPI_providerRemove for bem-sucedida e o sistema de telefonia estiver ativo no momento, o TAPI chamará lineShutdown e/ou phoneShutdown no provedor de serviços (dependendo de quais tipos de dispositivo estão ativos). Todos os identificadores de linha ou telefone ainda mantidos por aplicativos em dispositivos associados são fechados à força com mensagens LINE_CLOSE ou PHONE_CLOSE (é preferível que os provedores de serviço emitam essas mensagens como parte do TSPI_providerRemove, após a verificação com o usuário). Os dispositivos anteriormente sob o controle desse provedor são marcados como "indisponíveis", de modo que quaisquer tentativas futuras de aplicativos para referenciá-los por identificador de dispositivo resultem em LINEERR_NODRIVER.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |