funzione TSPI_phoneGetButtonInfo (tspi.h)

La funzione TSPI_phoneGetButtonInfo restituisce informazioni su un pulsante specificato.

Sintassi

LONG TSPIAPI TSPI_phoneGetButtonInfo(
  HDRVPHONE         hdPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Parametri

hdPhone

Handle per il telefono da eseguire una query.

dwButtonLampID

Pulsante sul dispositivo telefonico.

lpButtonInfo

Puntatore alla memoria in cui il provider di servizi scrive una struttura variabile di tipo PHONEBUTTONINFO. Questa struttura di dati descrive la modalità e la funzione e fornisce testo descrittivo aggiuntivo corrispondente al pulsante. Prima di chiamare TSPI_phoneGetButtonInfo, l'applicazione imposta il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

Valore restituito

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NOMEM.

Commenti

La funzione TSPI_phoneGetButtonInfo restituisce il valore PHONEERR_NOMEM se il provider di servizi non può accedere alla memoria contenente le informazioni sul pulsante.

Il provider di servizi compila tutti i membri della struttura di dati PHONEBUTTONINFO , ad eccezione di dwTotalSize, che viene compilato da TAPI. Il provider di servizi non deve sovrascrivere il membro dwTotalSize .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneSetButtonInfo