LINEAGENTCAPS-Struktur (tapi.h)

Artikel
03/06/2024

Die LINEAGENTCAPS-Struktur beschreibt die Funktionen eines ACD-Agents. Die lineGetAgentCaps-Funktion gibt die LINEAGENTCAPS-Struktur zurück.

Syntax

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;

Member

dwTotalSize

Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.

dwNeededSize

Größe, die erforderlich ist, um alle angeforderten Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.

dwAgentHandlerInfoSize

Größe der Agenthandlerinformationen in Byte.

dwAgentHandlerInfoOffset

Offset vom Anfang der -Struktur zu einer NULL-endenden Zeichenfolge, die den Namen, die Version oder andere identifizierende Informationen der Serveranwendung angibt, die Agentanforderungen verarbeitet. Die Größe der Zeichenfolge wird von dwAgentHandlerInfoSize angegeben.

dwCapsVersion

TAPI-Version, die von der Agenthandleranwendung zum Vorbereiten des Inhalts dieser Struktur verwendet wurde. Dies ist nicht größer als die API-Version, die die aufrufende Anwendung an lineGetAgentCaps übergeben hat.

dwFeatures

Agentbezogene Features, die für diese Zeile verfügbar sind, verwenden die LINEAGENTFEATURE_ Konstanten. Für das Aufrufen eines unterstützten Features müssen sich zeile und adresse im richtigen Zustand befinden. Eine Null in einer Bitposition gibt an, dass das entsprechende Feature nie verfügbar ist. Eine gibt an, dass das entsprechende Feature möglicherweise verfügbar ist, wenn sich die Zeile im geeigneten Zustand befindet, damit der Vorgang sinnvoll ist. Mit diesem Feld kann eine Anwendung ermitteln, welche Agent-Features vom Gerät unterstützt werden können (und welche niemals).

dwStates

LINEAGENTSTATE_ Konstanten , die im dwAgentState-Parameter von lineSetAgentState verwendet werden können. Wenn Sie einen unterstützten Zustand festlegen, müssen sich Zeile und Adresse im richtigen Zustand befinden. Eine Null in einer Bitposition gibt an, dass der entsprechende Zustand nie verfügbar ist. Eine gibt an, dass der entsprechende Zustand möglicherweise verfügbar ist, wenn sich die Zeile in dem geeigneten Zustand befindet, damit der Zustand aussagekräftig ist. Mit diesem Feld kann eine Anwendung ermitteln, welche Agent-Zustände auf dem Gerät unterstützt werden können (und welche niemals unterstützt werden können).

dwNextStates

LINEAGENTSTATE_ Konstanten, die im dwNextAgentState-Parameter von lineSetAgentState verwendet werden können. Wenn Sie einen unterstützten Zustand festlegen, müssen sich Zeile und Adresse im richtigen Zustand befinden. Eine Null in einer Bitposition gibt an, dass der entsprechende Zustand nie verfügbar ist. Eine gibt an, dass der entsprechende Zustand möglicherweise verfügbar ist, wenn sich die Zeile in dem geeigneten Zustand befindet, damit der Zustand aussagekräftig ist. Mit diesem Feld kann eine Anwendung ermitteln, welche Agent-Zustände auf dem Gerät unterstützt werden können (und welche niemals unterstützt werden können).

dwMaxNumGroupEntries

Maximale Anzahl von Agent-IDs, die gleichzeitig in der Adresse angemeldet werden können. Bestimmt den höchsten Wert, der als dwNumEntries-Member in der LINEAGENTGROUPLIST-Struktur an lineSetAgentGroup übergeben werden kann.

dwAgentStatusMessages

Gibt die LINEAGENTSTATUS_ Konstanten an, die von der Anwendung in dwParam2 einer LINE_AGENTSTATUS-Nachricht empfangen werden können.

dwNumAgentExtensionIDs

Anzahl der LINEEXTENSIONID-Strukturen , die im ExtensionIDList-Array angezeigt werden. Der Wert ist 0, wenn agenthandlerspezifische Erweiterungen für die Adresse unterstützt werden.

dwAgentExtensionIDListSize

Größe des Arrays der Agent-Erweiterungs-IDs in Bytes.

dwAgentExtensionIDListOffset

Offset vom Anfang der -Struktur zu einem Array von LINEEXTENSIONID-Strukturen . Die Größe ist dwNumExtensionIDs mal SIZEOF(LINEEXTENSIONID). Das Array listet die universellen 128-Bit-Bezeichner für alle agent-handlerspezifischen Erweiterungen auf, die vom Agenthandle für die Adresse unterstützt werden. Auf die verwendete Erweiterung wird in der lineAgentSpecific-Funktion verwiesen und LINE_AGENTSPECIFIC Nachricht durch ihre Position in dieser Tabelle, wobei der erste Eintrag Eintrag 0 ist. Daher ist es wichtig, dass der Agent-Handler erweiterungsbezeichner in diesem Array immer in derselben Reihenfolge darstellt. Die Größe des Arrays wird durch dwAgentExtensionIDListOffset angegeben.

ProxyGUID

GUID für den ACD-Proxy, der der Zeile zugeordnet ist. Dieses Element wird nur für Anwendungen verfügbar gemacht, die eine TAPI-Version von 2.2 oder höher aushandeln.