Funzione lineClose (tapi.h)

Articolo
03/05/2024

La funzione lineClose chiude il dispositivo a riga aperta specificato.

Sintassi

LONG lineClose(
  HLINE hLine
);

Parametri

hLine

Handle per il dispositivo a riga aperta da chiudere. Dopo la chiusura della riga, l'handle non è più valido.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Commenti

Se un'applicazione chiama lineClose mentre ha ancora chiamate attive sulla riga aperta, viene revocata la proprietà di queste chiamate dell'applicazione. Se l'applicazione è l'unico proprietario di queste chiamate, vengono eliminate anche le chiamate. È buona norma di programmazione per un'applicazione eliminare le chiamate di cui è proprietaria su una riga aperta rinunciando esplicitamente alla proprietà e/o rimuovendo queste chiamate prima di chiudere la riga.

Se la riga è stata chiusa correttamente, viene inviato un messaggio LINE_LINEDEVSTATE a tutte le applicazioni che monitorano lo stato della riga delle modifiche aperte/chiuse. Le risposte asincrone in attesa vengono eliminate.

I provider di servizi possono trovare utile o necessario recuperare forzatamente i dispositivi line da un'applicazione con la riga aperta. Ciò può essere utile per impedire a un'applicazione di monopolizzare il dispositivo linea per troppo tempo. In questo caso, all'applicazione viene inviato un messaggio di LINE_CLOSE, specificando l'handle di riga del dispositivo di riga chiuso.

La funzione lineOpen alloca le risorse all'applicazione chiamante e le applicazioni possono impedire l'apertura di una riga se le risorse non sono disponibili. Pertanto, un'applicazione che usa solo occasionalmente un dispositivo linea (ad esempio per effettuare chiamate in uscita) deve chiudere la riga per liberare risorse e consentire ad altre applicazioni di aprire la riga.