função TSPI_providerConfig (tspi.h)
A função TSPI_providerConfig está obsoleta. Os provedores de serviços TAPI versão 1.4 ou anteriores podem implementar essa função TSPI. Os TSPs tapi versão 2.0 ou posterior implementam TUISPI_providerConfig.
A função TSPI_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 associadas a outras APIs (como Comm/datamodem) para a configuração de dispositivos específicos.
Sintaxe
LONG TSPIAPI TSPI_providerConfig(
HWND hwndOwner,
DWORD dwPermanentProviderID
);
Parâmetros
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 valores retornados possíveis 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).
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 reiniciado no próximo TSPI_providerInit.
O utilitário Painel de Controle telefonia fornecido com o Windows Telephony nas versões 1.4 e anteriores chama essa função quando o comando de instalação é invocado.
Não há nenhuma função diretamente correspondente 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 |