Struttura LINEAGENTCAPS (tapi.h)

Articolo
03/05/2024

La struttura LINEAGENTCAPS descrive le funzionalità di un agente ACD. La funzione lineGetAgentCaps restituisce la struttura LINEAGENTCAPS .

Sintassi

typedef struct lineagentcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwAgentHandlerInfoSize;
  DWORD dwAgentHandlerInfoOffset;
  DWORD dwCapsVersion;
  DWORD dwFeatures;
  DWORD dwStates;
  DWORD dwNextStates;
  DWORD dwMaxNumGroupEntries;
  DWORD dwAgentStatusMessages;
  DWORD dwNumAgentExtensionIDs;
  DWORD dwAgentExtensionIDListSize;
  DWORD dwAgentExtensionIDListOffset;
  GUID  ProxyGUID;
} LINEAGENTCAPS, *LPLINEAGENTCAPS;

Members

dwTotalSize

Dimensioni totali assegnate a questa struttura di dati, in byte.

dwNeededSize

Dimensioni necessarie per contenere tutte le informazioni richieste, in byte.

dwUsedSize

Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.

dwAgentHandlerInfoSize

Dimensioni delle informazioni del gestore dell'agente, in byte.

dwAgentHandlerInfoOffset

Offset dall'inizio della struttura a una stringa con terminazione null specificando il nome, la versione o altre informazioni di identificazione dell'applicazione server che gestisce le richieste dell'agente. Le dimensioni della stringa sono specificate da dwAgentHandlerInfoSize.

dwCapsVersion

Versione TAPI usata dall'applicazione del gestore dell'agente per preparare il contenuto di questa struttura. Non è maggiore della versione dell'API che l'applicazione chiamante passata a lineGetAgentCaps.

dwFeatures

Funzionalità correlate all'agente disponibili per questa riga usando le costanti LINEAGENTFEATURE_. Richiamare una funzionalità supportata richiede che la riga e l'indirizzo siano nello stato appropriato. Zero in una posizione bit indica che la funzionalità corrispondente non è mai disponibile. Un valore indica che la funzionalità corrispondente può essere disponibile se la riga è nello stato appropriato per l'operazione in modo significativo. Questo campo consente a un'applicazione di individuare quali funzionalità dell'agente possono essere (e che non possono mai essere) supportate dal dispositivo.

dwStates

LINEAGENTSTATE_ costanti che possono essere usate nel parametro dwAgentState di lineSetAgentState. L'impostazione di uno stato supportato richiede che la riga e l'indirizzo siano nello stato appropriato. Uno zero in una posizione bit indica che lo stato corrispondente non è mai disponibile. Uno indica che lo stato corrispondente può essere disponibile se la riga è nello stato appropriato per lo stato che deve essere significativo. Questo campo consente a un'applicazione di individuare gli stati dell'agente che possono essere (e che non possono mai essere) supportati nel dispositivo.

dwNextStates

LINEAGENTSTATE_ costanti che possono essere usate nel parametro dwNextAgentState di lineSetAgentState. L'impostazione di uno stato supportato richiede che la riga e l'indirizzo siano nello stato appropriato. Uno zero in una posizione bit indica che lo stato corrispondente non è mai disponibile. Uno indica che lo stato corrispondente può essere disponibile se la riga è nello stato appropriato per lo stato che deve essere significativo. Questo campo consente a un'applicazione di individuare gli stati dell'agente che possono essere (e che non possono mai essere) supportati nel dispositivo.

dwMaxNumGroupEntries

Numero massimo di identificatori dell'agente che possono essere connessi contemporaneamente all'indirizzo. Determina il valore più alto che può essere passato come membro dwNumEntries nella struttura LINEAGENTGROUPLIST a lineSetAgentGroup.

dwAgentStatusMessages

Indica le costanti LINEAGENTSTATUS_ che possono essere ricevute dall'applicazione in dwParam2 di un messaggio di LINE_AGENTSTATUS .

dwNumAgentExtensionIDs

Numero di strutture LINEEXTENSIONID visualizzate nella matrice ExtensionIDList . Il valore è 0 se le estensioni specifiche del gestore agente sono supportate nell'indirizzo.

dwAgentExtensionIDListSize

Dimensioni della matrice ID dell'estensione dell'agente, in byte.

dwAgentExtensionIDListOffset

Offset dall'inizio della struttura a una matrice di strutture LINEEXTENSIONID . Le dimensioni sono dwNumExtensionIDs volte SIZEOF(LINEEXTENSIONID). La matrice elenca gli identificatori universalmente univoci a 128 bit per tutte le estensioni specifiche del gestore agente supportate dall'handle dell'agente per l'indirizzo. L'estensione usata viene fatto riferimento nella funzione lineAgentSpecific e LINE_AGENTSPECIFIC messaggio in base alla sua posizione in questa tabella, la prima voce 0, quindi è importante che il gestore dell'agente presenti sempre gli identificatori di estensione in questa matrice nello stesso ordine. Le dimensioni della matrice sono specificate da dwAgentExtensionIDListOffset.

ProxyGUID

GUID per il proxy ACD associato alla riga. Questo elemento è esposto solo alle applicazioni che negoziano una versione TAPI di 2.2 o successiva.