Funzione lineReleaseUserUserInfo (tapi.h)

Articolo
03/08/2023

La funzione lineReleaseUserUserInfo informa il provider di servizi che l'applicazione ha elaborato le informazioni utente contenute nella struttura LINECALLINFO e che le informazioni utente ricevute successivamente possono essere scritte in tale struttura. Il provider di servizi invia un messaggio di LINE_CALLINFO che indica LINECALLINFOSTATE_USERUSERINFO quando sono disponibili nuove informazioni.

Sintassi

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Parametri

hCall

Gestire la chiamata. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall può essere qualsiasi stato.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED LINEERR_OPERATIONUNAVAIL.

Commenti

La funzione lineReleaseUserUserInfo consente all'applicazione di controllare il flusso delle informazioni utente in ingresso su una connessione ISDN. Quando viene ricevuto un nuovo messaggio di informazioni utente completo, il provider di servizi informa l'applicazione usando un messaggio di LINE_CALLINFO (specificando LINECALLINFOSTATE_USERUSERINFO). Qualsiasi numero di applicazioni può esaminare le informazioni (usando lineGetCallInfo), ma l'applicazione proprietaria dei controlli delle chiamate quando vengono rilasciate le informazioni in modo che possano essere segnalate informazioni successive. Il provider di servizi non sovrascriverà le informazioni utente precedenti in LINECALLINFO con informazioni più recenti fino a quando non viene chiamato lineReleaseUserUserInfo . È responsabilità del provider di servizi memorizzare nel buffer le informazioni utente ricevute successivamente fino a quando le informazioni precedenti non vengono rilasciate dall'applicazione proprietaria della chiamata.