Condividi tramite


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

LINECALLINFO

LINE_CALLINFO

Panoramica di riferimento su TAPI 2.2

lineGetCallInfo