Funzione lineGetAgentCapsA (tapi.h)

Articolo
11/20/2024

La funzione lineGetAgentCaps ottiene le funzionalità correlate all'agente supportate nel dispositivo linea specificato. Se un agente specifico è denominato, le funzionalità includono un elenco di gruppi di Progettazione immagine e configurazione di Azure in cui è consentito l'accesso dell'agente.

Sintassi

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Dispositivo linea contenente l'indirizzo su cui eseguire una query.

dwAddressID

Indirizzo nel dispositivo linea specificato le cui funzionalità devono essere sottoposte a query. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAppAPIVersion

Versione più recente dell'API supportata dall'applicazione. Questo non deve essere il valore negoziato usando lineNegotiateAPIVersion nel dispositivo su cui viene eseguita una query.

lpAgentCaps

Puntatore a una struttura di dimensioni variabili di tipo LINEAGENTCAPS. Al termine della richiesta, questa struttura viene compilata con informazioni sulle funzionalità dell'agente. Prima di chiamare lineGetAgentCaps, l'applicazione deve impostare l'membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire 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_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Osservazioni

Nota

L'intestazione tapi.h definisce lineGetAgentCaps 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.