funzione TSPI_lineSetAppSpecific (tspi.h)

La funzione TSPI_lineSetAppSpecific imposta il campo specifico dell'applicazione della struttura LINECALLINFO della chiamata specificata.

Sintassi

LONG TSPIAPI TSPI_lineSetAppSpecific(
  HDRVCALL hdCall,
  DWORD    dwAppSpecific
);

Parametri

hdCall

Handle alla chiamata il cui campo specifico dell'applicazione deve essere impostato. Lo stato della chiamata di hdCall può essere qualsiasi stato.

dwAppSpecific

Nuovo contenuto del membro dwAppSpecific per la struttura LINECALLINFO della chiamata. Questo valore non viene interpretato dal provider di servizi. Questo parametro non viene convalidato da TAPI quando questa funzione viene chiamata.

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:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

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 TSPI_lineGetCallInfo. Tuttavia, TSPI_lineSetAppSpecific deve essere usato per impostare il campo in modo che le modifiche diventino visibili ad altre applicazioni. Quando questo campo viene modificato, il provider di servizi invia un messaggio di LINE_CALLINFO con un'indicazione che il campo AppSpecific è stato modificato.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

LINECALLINFO

LINE_CALLINFO

TSPI_lineGetCallInfo