Funzione lineGetStatusMessages (tapi.h)
La funzione lineGetStatusMessages consente a un'applicazione di eseguire una query sui messaggi di notifica che l'applicazione è configurata per ricevere gli eventi correlati alle modifiche di stato per la riga specificata o per uno dei relativi indirizzi.
Sintassi
LONG lineGetStatusMessages(
HLINE hLine,
LPDWORD lpdwLineStates,
LPDWORD lpdwAddressStates
);
Parametri
hLine
Handle per il dispositivo line.
lpdwLineStates
Matrice di bit che identifica per quale stato del dispositivo della riga cambia un messaggio da inviare all'applicazione. Se un flag è TRUE, il messaggio è abilitato; se FALSE, è disabilitato. Questo parametro usa una o più costanti LINEDEVSTATE_.
lpdwAddressStates
Matrice di bit che identifica per quale stato dell'indirizzo cambia un messaggio da inviare all'applicazione. Se un flag è TRUE, il messaggio è abilitato; se FALSE, disabilitato. Questo parametro usa una o più costanti LINEADDRESSSTATE_.
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_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Commenti
TAPI definisce un numero di messaggi che notificano alle applicazioni gli eventi che si verificano su righe e indirizzi. Un'applicazione potrebbe non essere interessata a ricevere tutti i messaggi di modifica dello stato dell'indirizzo e della riga. La funzione lineSetStatusMessages può essere usata per selezionare i messaggi che l'applicazione desidera ricevere. Per impostazione predefinita, lo stato dell'indirizzo e la segnalazione dello stato della riga sono disabilitati.
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