funzione lineAgentSpecific (tapi.h)

Articolo
03/02/2024

La funzione lineAgentSpecific consente all'applicazione di accedere a funzioni specifiche del gestore proprietario del gestore dell'agente associato all'indirizzo. Il significato delle estensioni è specifico del gestore dell'agente. Ogni set di estensioni correlate all'agente è identificato da un ID di estensione a 128 bit univoco che deve essere ottenuto, insieme alla specifica per l'estensione, dal promulgatore di tale estensione (in genere l'autore del software del gestore agente nel server di telefonia). L'elenco delle estensioni supportate dal gestore dell'agente viene ottenuto dalla struttura LINEAGENTCAPS restituita da lineGetAgentCaps.

Sintassi

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Parametri

hLine

Gestire il dispositivo a riga aperta.

dwAddressID

Indirizzo nel dispositivo a riga aperta. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAgentExtensionIDIndex

Posizione nella struttura ExtensionIDList in LINEAGENTCAPS dell'estensione del gestore dell'agente richiamata.

lpParams

Puntatore a un'area di memoria usata per contenere un blocco di parametri. Il formato di questo blocco di parametri è specifico del dispositivo e il relativo contenuto viene passato da TAPI a e dall'applicazione gestore agente nel server di telefonia. Questo blocco di parametri deve specificare la funzione da richiamare e includere una stanza sufficiente per i dati da restituire.

dwSize

Dimensioni dell'area del blocco dei parametri, in byte.

Nota Se lpParams è un puntatore a una stringa, le dimensioni devono includere il terminatore NULL .

Valore restituito

Restituisce un identificatore di richiesta positivo se l'operazione asincrona viene avviata; in caso contrario, questa funzione restituisce uno dei valori di errore negativi seguenti:

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

I valori restituiti aggiuntivi sono specifici del gestore dell'agente.

Commenti

Questa operazione fa parte dei servizi di telefonia estesa. Fornisce l'accesso a una funzionalità specifica del gestore agente senza definirne il significato.

Questa funzione fornisce un profilo di parametro generico. L'interpretazione della struttura dei parametri è specifica del gestore. Le indicazioni e le risposte inviate all'applicazione specifiche del gestore devono usare il messaggio di LINE_AGENTSPECIFIC .

Un gestore agente può fornire l'accesso alle funzioni specifiche del gestore definendo i parametri da usare con questa funzione. Le applicazioni che vogliono usare queste estensioni devono consultare la documentazione specifica del fornitore che descrive le estensioni definite. In genere, un'applicazione che si basa su queste estensioni non è in grado di lavorare con altri ambienti del gestore agente.