Funzione lineGetAgentActivityListA (tapi.h)

La funzione lineGetAgentActivityList ottiene le identità delle attività che l'applicazione può selezionare usando lineSetAgentActivity per indicare quale funzione l'agente sta effettivamente eseguendo 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 di dimensioni variabili di tipo LINEAGENTACTIVITYLIST. Al termine della richiesta, questa struttura viene compilata con un elenco dei codici attività dell'agente che possono essere selezionati usando 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

LINEAGENTACTIVITYLIST

funzioni supplementari del servizio linea

panoramica dei riferimenti TAPI 2.2

lineSetAgentActivity