funzione lineSetStatusMessages (tapi.h)

Articolo
03/05/2024

La funzione lineSetStatusMessages consente a un'applicazione di specificare quali messaggi di notifica ricevere per gli eventi correlati alle modifiche dello stato per la riga specificata o uno dei relativi indirizzi.

Sintassi

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

Parametri

hLine

Gestire il dispositivo linea.

dwLineStates

Matrice di bit che identifica per quale stato del dispositivo riga modifica un messaggio da inviare all'applicazione. Questo parametro usa una o più costanti LINEDEVSTATE_.

dwAddressStates

Matrice bit che identifica per lo stato dell'indirizzo che modifica un messaggio deve essere inviato all'applicazione. Questo parametro usa una o più costanti LINEADDRESSSTATE_.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

Commenti

TAPI definisce un numero di messaggi che informano le applicazioni sugli eventi che si verificano su righe e indirizzi. Un'applicazione potrebbe non essere interessata alla ricezione di tutti i messaggi di modifica dello stato della riga e dell'indirizzo. La funzione lineSetStatusMessages può essere usata per selezionare i messaggi ricevuti dall'applicazione. Per impostazione predefinita, la segnalazione dello stato dell'indirizzo e della riga è disabilitata.