funzione lineSetAppSpecific (tapi.h)
La funzione lineSetAppSpecific consente a un'applicazione di impostare il campo specifico dell'applicazione del record call-information della chiamata specificata.
Sintassi
LONG lineSetAppSpecific(
HCALL hCall,
DWORD dwAppSpecific
);
Parametri
hCall
Gestire la chiamata il cui campo specifico dell'applicazione deve essere impostato. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall può essere qualsiasi stato.
dwAppSpecific
Nuovo contenuto del membro dwAppSpecific per la struttura LINECALLINFO della chiamata. Questo valore non viene interpretato dall'API Telefonia.
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:
LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.
Commenti
Il campo specifico dell'applicazione nella struttura di dati LINECALLINFO esistente per ogni chiamata non viene interpretato dall'API Telefonia o da uno dei relativi provider di servizi. L'utilizzo è completamente definito dalle applicazioni. Il campo può essere letto dal record LINECALLINFO restituito da lineGetCallInfo. Tuttavia, lineSetAppSpecific deve essere usato per impostare il campo in modo che le modifiche diventino visibili ad altre applicazioni. Quando questo campo viene modificato, tutte le altre applicazioni con handle di chiamata vengono inviate un messaggio di LINE_CALLINFO con un'indicazione che il membro dwAppSpecific è stato modificato.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |
Vedi anche
Informazioni di riferimento sui servizi di telefonia di base