Funzione lineGetLineDevStatus (tapi.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |
Vedi anche
Informazioni di riferimento sui servizi di telefonia di base