funzione lineSetAppSpecific (tapi.h)

Articolo
03/02/2024

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.