funzione phoneGetStatusMessages (tapi.h)

Articolo
03/02/2024

La funzione phoneGetStatusMessages restituisce le modifiche dello stato del telefono nel dispositivo telefonico specificato generano un callback all'applicazione.

Sintassi

LONG phoneGetStatusMessages(
  HPHONE  hPhone,
  LPDWORD lpdwPhoneStates,
  LPDWORD lpdwButtonModes,
  LPDWORD lpdwButtonStates
);

Parametri

hPhone

Gestire il dispositivo telefono aperto da monitorare.

lpdwPhoneStates

Puntatore a un DWORD che contiene zero, una o più costanti PHONESTATE_. Questi flag specificano il set di modifiche dello stato del telefono ed eventi per i quali l'applicazione può ricevere messaggi di notifica. Il monitoraggio può essere abilitato singolarmente e disabilitato.

lpdwButtonModes

Puntatore a un DWORD contenente flag che specificano il set di modalità del pulsante telefonico per cui l'applicazione può ricevere messaggi di notifica. Questo parametro usa zero, una o più costanti PHONEBUTTONMODE_.

lpdwButtonStates

Puntatore a un DWORD che contiene flag che specificano il set di modifiche dello stato del pulsante telefonico per cui l'applicazione può ricevere messaggi di notifica. Questo parametro usa zero, uno o più delle costanti PHONEBUTTONSTATE_.

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:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_UNINITIALIZED.

Commenti

Un'applicazione può usare phoneGetStatusMessages per eseguire query sulla generazione dei messaggi corrispondenti. La generazione dei messaggi può essere controllata da phoneGetStatusMessages. Tutti i messaggi di stato del telefono sono disabilitati per impostazione predefinita.