função TSPI_providerShutdown (tspi.h)
A função TSPI_providerShutdown desliga o provedor de serviços. O provedor de serviços encerra todas as atividades que tem em andamento e libera todos os recursos alocados.
Sintaxe
LONG TSPIAPI TSPI_providerShutdown(
DWORD dwTSPIVersion,
DWORD dwPermanentProviderID
);
Parâmetros
dwTSPIVersion
A versão da definição de TSPI sob a qual essa função deve operar. O chamador pode usar TSPI_lineNegotiateTSPIVersion ou TSPI_phoneNegotiateTSPIVersion com o dwDeviceID especial INITIALIZE_NEGOTIATION para negociar uma versão que é garantida como aceitável para o provedor de serviços.
dwPermanentProviderID
Esse parâmetro permite que o provedor de serviços determine quais entre várias instâncias possíveis do provedor de serviços estão sendo desligadas. O valor do parâmetro é idêntico ao passado no parâmetro de mesmo nome em TSPI_providerInit.
Valor retornado
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_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.
Comentários
A chamada emparelhada final para essa função deve ser a última chamada para qualquer uma das funções TSPI prefixadas com TSPI_line ou TSPI_phone diferente de TSPI_lineNegotiateTSPIVersion ou TSPI_phoneNegotiateTSPIVersion. É responsabilidade do chamador garantir isso.
Essa função sempre deve ter êxito, exceto em circunstâncias extraordinárias. A maioria dos chamadores provavelmente ignorará o código de retorno porque eles não poderão compensar nenhum erro que ocorra. Os valores retornados especificados são mais consultivos para fins de diagnóstico de desenvolvimento do que qualquer outra coisa.
Não há nenhuma função correspondente diretamente no TAPI. No TAPI, várias instâncias de uso diferentes podem ser pendentes, com um parâmetro "identificador de aplicativo" para identificar a instância a ser operada. No TSPI, a arquitetura de interface dá suporte apenas a uma única instância de uso para cada provedor de serviços distinto.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |