função TUISPI_providerConfig (tspi.h)
A função TUISPI_providerConfig implementa os elementos de interface do usuário que devem ser executados no contexto do aplicativo de chamada. Essa função torna a função TSPI_providerConfig obsoleta na versão 2.0 e posterior (com suporte na versão 1.4 e anterior).
A função TUISPI_providerConfig coleta informações de configuração do usuário. Ele pode usar uma caixa de diálogo e essa caixa de diálogo pode incluir caixas de diálogo de subconsultas associadas a outras APIs (como Comm/datamodem) para a instalação de dispositivos específicos.
A implementação é opcional.
Sintaxe
LONG TSPIAPI TUISPI_providerConfig(
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 e enviar a configuração atualizada para o provedor de serviços.
hwndOwner
O identificador da janela pai na qual a função pode criar qualquer janela de caixa de diálogo necessária durante a configuraçã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_NOMEM.
Comentários
Essa função pode ser chamada enquanto o provedor de serviços está em uso (ou seja, entre chamadas de TSPI_providerInit e TSPI_providerShutdown).
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 reiniciado no próximo TSPI_providerInit.
Não há nenhuma função correspondente diretamente no nível TAPI. No TAPI, os aplicativos têm acesso às funções lineConfigDialog e phoneConfigDialog, que permitem a configuração de parâmetros de uma linha ou telefone específico depois de instalado.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |