ITAgent::get_AgentSessions-Methode (tapi3.h)

Die get_AgentSessions-Methode erstellt eine Sammlung aktueller Agentsitzungen. Diese Methode wird für Automation-Clientanwendungen bereitgestellt, z. B. für in Visual Basic geschriebene Anwendungen. C- und C++-Anwendungen müssen die EnumerateAgentSessions-Methode verwenden.

Syntax

HRESULT get_AgentSessions(
  [out] VARIANT *pVariant
);

Parameter

[out] pVariant

Zeiger auf VARIANT , der eine ITCollection von ITAgentSession-Schnittstellenzeigern (Agentsitzungsobjekte) enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S_OK
Methode war erfolgreich.
E_POINTER
Der pVariant-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

TAPI ruft die AddRef-Methode auf der ITAgentSession-Schnittstelle auf, die von ITAgent::get_AgentSessions zurückgegeben wird. Die Anwendung muss Release auf der ITAgentSession-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen

   
Zielplattform Windows
Kopfzeile tapi3.h (Tapi3.h einschließen)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

EnumerateAgentSessions

ITAgent

ITAgentSession

ITCollection