funzione TSPI_providerShutdown (tspi.h)

Articolo
08/26/2023

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.