funzione phoneGetStatus (tapi.h)

La funzione phoneGetStatus consente a un'applicazione di eseguire query sul dispositivo telefono aperto specificato per il relativo stato complessivo.

Sintassi

LONG phoneGetStatus(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto da eseguire una query.

lpPhoneStatus

Puntatore a una struttura di dati di dimensioni variabile del tipo PHONESTATUS, che viene caricato con le informazioni restituite sullo stato del telefono.

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_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Commenti

Un'applicazione può usare questa funzione per determinare lo stato corrente di un dispositivo telefonico aperto. Le informazioni sullo stato descrivono informazioni sui dispositivi hookswitch del dispositivo telefonico, ringer, volume, display e lampade.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tapi.h
Libreria	Tapi32.lib
DLL	Tapi32.dll

Vedi anche

PHONESTATUS

Funzioni di servizio telefonico supplementari

Panoramica di riferimento su TAPI 2.2