funzione TSPI_phoneClose (tspi.h)
La funzione TSPI_phoneClose chiude il dispositivo aperto specificato dopo aver completato o interrotto tutte le operazioni asincrone in sospeso nel dispositivo.
Sintassi
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
Parametri
hdPhone
La gestione opaca del provider di servizi per il telefono da chiudere. Dopo la chiusura del telefono, questa handle non è più valida.
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:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Commenti
Il provider di servizi deve segnalare il completamento per ogni operazione asincrona. Se questa procedura viene chiamata per un telefono in cui sono presenti operazioni asincrone in sospeso, le operazioni devono essere segnalate complete con un risultato o un codice di errore appropriato prima che questa procedura venga restituita. In genere, TAPI attende che questi vengano completati in modo ordinato. Tuttavia, il provider di servizi deve essere preparato per gestire una chiamata anticipata per TSPI_phoneClose in situazioni di "interruzione" o "arresto di emergenza".
Dopo aver restituito questa procedura, il provider di servizi non deve segnalare altri eventi sul telefono. L'handle opaco del provider di servizi per il telefono diventa non valido.
Il provider di servizi deve rimettere le risorse non condivisibili che riserva mentre il telefono è aperto. Ad esempio, la chiusura di un telefono a cui si accede tramite una porta comm e un modem dovrebbe comportare la chiusura della porta comm, rendendola disponibile per l'uso da parte di altre applicazioni.
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.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |