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 |