Funzione phoneSetStatusMessages (tapi.h)

Articolo
08/26/2023

La funzione phoneSetStatusMessages consente a un'applicazione di monitorare il dispositivo telefonico specificato per gli eventi di stato selezionati.

Sintassi

LONG phoneSetStatusMessages(
  HPHONE hPhone,
  DWORD  dwPhoneStates,
  DWORD  dwButtonModes,
  DWORD  dwButtonStates
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto da monitorare.

dwPhoneStates

Set di modifiche dello stato del telefono ed eventi per i quali l'applicazione può ricevere messaggi di notifica. Questo parametro può avere zero, uno o più costanti PHONESTATE_.

dwButtonModes

Set di modalità del pulsante telefono per cui l'applicazione può ricevere messaggi di notifica. Questo parametro può avere zero, uno o più costanti PHONEBUTTONMODE_.

dwButtonStates

Set di modifiche dello stato del pulsante telefono per cui l'applicazione può ricevere messaggi di notifica. Se il parametro dwButtonModes è zero, dwButtonStates viene ignorato. Se dwButtonModes ha uno o più bit impostati, questo parametro deve avere almeno un bit impostato. Questo parametro usa le costanti PHONEBUTTONSTATE_.

Valore restituito

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Commenti

Un'applicazione può usare la funzione phoneSetStatusMessages per abilitare o disabilitare la generazione dei messaggi corrispondenti. Tutti i messaggi di stato del telefono sono disabilitati per impostazione predefinita.