funzione TSPI_linePark (tspi.h)

Articolo
08/26/2023

La funzione TSPI_linePark parcheggia la chiamata specificata in base alla modalità di parco specificata.

Sintassi

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle della chiamata da parcheggiare. Lo stato della chiamata di hdCall può essere connesso.

dwParkMode

Modalità parco con cui la chiamata deve essere parcheggiata, solo una delle costanti LINEPARKMODE_.

lpszDirAddress

Puntatore alla stringa Unicode con terminazione Null che indica l'indirizzo in cui deve essere parcheggiata la chiamata quando si usa il parco diretto. L'indirizzo è in formato di indirizzo chiamabile. Questo parametro viene ignorato per il parco non diretto.

lpNonDirAddress

Puntatore a una struttura di tipo VARSTRING. Per il parcheggio non diretto, l'indirizzo in cui viene parcheggiata la chiamata viene restituito in questa struttura. Questo parametro viene ignorato per il parco diretto. All'interno della struttura VARSTRING, dwStringFormat deve essere impostato su STRINGFORMAT_ASCII (un buffer di stringhe ASCII contenente una stringa con terminazione Null) e la terminazione NULL viene considerata in dwStringSize. Se la memoria a cui punta il parametro lpNonDirAddress non è sufficiente per l'indirizzo richiesto, la funzione TSPI_linePark restituisce LINEERR_STRUCTURETOOSMALL.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è 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_NOMEM, LINEERR_INVALPARKMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL.

Commenti

Tutti i membri della struttura VARSTRING , ad eccezione di dwTotalSize, vengono compilati dal provider di servizi. Il membro dwTotalSize viene compilato da TAPI e il provider di servizi non deve sovrascrivere questo valore.

Nel parco diretto, l'applicazione client (tramite TAPI) specifica l'indirizzo in cui vuole parcheggiare la chiamata. Nel parcheggio non diretto, il commutatore determina l'indirizzo e lo fornisce a TAPI. In entrambi i casi, una chiamata parcheggiata può essere scaricata specificando questo indirizzo.

La chiamata parcheggiata in genere entra nello stato di chiamata inattiva dopo che è stato parcheggiato correttamente. Il provider di servizi segnala il nuovo stato usando un messaggio di LINE_CALLSTATE . Un TSPI_lineUnpark successivo crea un nuovo handle di chiamata distinto, indipendentemente dal fatto che TSPI_lineCloseCall abbia eliminato definitivamente l'handle precedente.

Alcuni commutatori possono ricordare all'utente dopo che una chiamata è stata parcheggiata per un lungo periodo di tempo. Il provider di servizi lo segnala a TAPI come chiamata di offerta con un motivo di chiamata impostato su promemoria (se noto).