Funzione lineGetLineDevStatus (tapi.h)

Articolo
03/05/2024

La funzione lineGetLineDevStatus consente a un'applicazione di eseguire una query sul dispositivo a riga aperta specificato per verificarne lo stato corrente.

Sintassi

LONG lineGetLineDevStatus(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

Parametri

hLine

Gestire il dispositivo a riga aperta su cui eseguire una query.

lpLineDevStatus

Puntatore a una struttura di dati con dimensioni variabili di tipo LINEDEVSTATUS. Al termine della richiesta, questa struttura viene riempita con lo stato del dispositivo della riga. Prima di chiamare lineGetLineDevStatus, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

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_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Commenti

Un'applicazione usa lineGetLineDevStatus per eseguire una query sul dispositivo della riga per verificarne lo stato corrente. Queste informazioni sullo stato si applicano a livello globale a tutti gli indirizzi nel dispositivo line. Usare lineGetAddressStatus per determinare le informazioni sullo stato relative a un indirizzo specifico in una riga.