Funzione lineGetStatusMessages (tapi.h)

Articolo
03/05/2024

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.