funzione TSPI_lineClose (tspi.h)

La funzione TSPI_lineClose chiude il dispositivo a riga aperta specificato dopo aver completato o interrotto tutte le chiamate in sospeso e le operazioni asincrone nel dispositivo.

Sintassi

LONG TSPIAPI TSPI_lineClose(
  HDRVLINE hdLine
);

Parametri

hdLine

Handle del provider di servizi per la riga da chiudere. Dopo la chiusura della riga, l'handle non è più valido.

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_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.

Commenti

Il provider di servizi deve segnalare il completamento per ogni operazione asincrona. Se viene chiamato TSPI_lineClose per una riga in cui sono presenti operazioni asincrone in sospeso, le operazioni vengono segnalate completate con un risultato o un codice di errore appropriato prima che questa procedura venga restituita.

Esiste un requisito simile per le chiamate attive sulla riga. Le operazioni in sospeso devono essere segnalate complete con i codici di errore o di risultato appropriati. Le chiamate attive devono essere eliminate, se necessario, e se questo comportamento è stato indicato dal bit LINEDEVCAPFLAGS_CLOSEDROP nella struttura LINEDEVCAPS .

Al termine di questa procedura, il provider di servizi non deve segnalare ulteriori htCall sulla riga o sulle chiamate presenti nella riga. Gli handle del provider di servizi per la riga e le chiamate sulla riga diventano "non validi".

Il provider di servizi deve rinunciare alle risorse non condivisibili che riserva mentre la riga è aperta. Ad esempio, la chiusura di una linea a cui si accede tramite una porta comm e un modem dovrebbe comportare la chiusura della porta comm, rendendola nuovamente disponibile per l'uso da parte di altre applicazioni.

Il provider di servizi non emette il messaggio di LINE_LINEDEVSTATE in risposta a questa chiamata di funzione perché la riga si chiude e non vi è più alcun interesse per le modifiche dello stato.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

LINEDEVCAPS

LINE_CLOSE

LINE_LINEDEVSTATE