funzione phoneSetButtonInfo (tapi.h)

La funzione phoneSetButtonInfo imposta informazioni sul pulsante specificato nel telefono specificato.

Sintassi

LONG phoneSetButtonInfo(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Parametri

hPhone

Gestire il dispositivo telefono aperto. L'applicazione deve essere il proprietario del dispositivo telefonico.

dwButtonLampID

Pulsante sul dispositivo telefonico.

lpButtonInfo

Puntatore a una struttura di dimensioni variabile di tipo PHONEBUTTONINFO. Questa struttura di dati descrive la modalità, la funzione e fornisce testo descrittivo aggiuntivo sul pulsante.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di PHONE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.

Requisiti

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

Vedi anche

PHONEBUTTONINFO

PHONE_REPLY

Funzioni di servizio telefonico supplementari

Panoramica di riferimento su TAPI 2.2