Funzione lineGetAgentActivityListA (tapi.h)

Articolo
08/26/2023

La funzione lineGetAgentActivityList ottiene le identità delle attività che l'applicazione può selezionare usando lineSetAgentActivity per indicare quale funzione sta effettivamente eseguendo l'agente al momento.

Sintassi

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

Parametri

hLine

Handle per il dispositivo a riga aperta.

dwAddressID

Indirizzo nel dispositivo a riga aperta il cui stato dell'agente deve essere sottoposto a query. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

lpAgentActivityList

Puntatore a una struttura con dimensioni variabili di tipo LINEAGENTACTIVITYLIST. Al termine della richiesta, questa struttura viene compilata con un elenco dei codici attività dell'agente che è possibile selezionare tramite lineSetAgentActivity. Prima di chiamare lineGetAgentActivityList, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

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_OPERATIONFAILED, LINEERR_INVALAGENTID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

Commenti

Nota

L'intestazione tapi.h definisce lineGetAgentActivityList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.