funzione TSPI_providerShutdown (tspi.h)
La funzione TSPI_providerShutdown arresta il provider di servizi. Il provider di servizi termina tutte le attività in corso e rilascia tutte le risorse allocate.
Sintassi
LONG TSPIAPI TSPI_providerShutdown(
DWORD dwTSPIVersion,
DWORD dwPermanentProviderID
);
Parametri
dwTSPIVersion
Versione della definizione TSPI in cui questa funzione deve funzionare. Il chiamante può usare TSPI_lineNegotiateTSPIVersion o TSPI_phoneNegotiateTSPIVersion con il INITIALIZE_NEGOTIATION dwDeviceIDspeciale per negoziare una versione che è garantita essere accettabile per il provider di servizi.
dwPermanentProviderID
Questo parametro consente al provider di servizi di determinare quale tra più istanze possibili del provider di servizi viene arrestato. Il valore del parametro è identico a quello passato nel parametro dello stesso nome in TSPI_providerInit.
Valore restituito
Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.
Commenti
La chiamata finale associata a questa funzione deve essere l'ultima chiamata a una delle funzioni TSPI precedute da TSPI_line o TSPI_phonediverse da TSPI_lineNegotiateTSPIVersion o TSPI_phoneNegotiateTSPIVersion. È responsabilità del chiamante garantire questo.
Questa funzione deve sempre avere esito positivo tranne in circostanze straordinarie. La maggior parte dei chiamanti ignora probabilmente il codice restituito perché non sarà in grado di compensare eventuali errori che si verificano. I valori restituiti specificati sono più consultivi per scopi di diagnostica di sviluppo rispetto a qualsiasi altro elemento.
Non esiste alcuna funzione corrispondente direttamente in TAPI. In TAPI più istanze di utilizzo diverse possono essere in sospeso, con un parametro "application handle" per identificare l'istanza da gestire. In TSPI l'architettura dell'interfaccia supporta solo un'istanza di utilizzo singola per ogni provider di servizi distinto.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |