Método ITAgent::get_AgentSessions (tapi3.h)

Artigo
08/26/2023

O método get_AgentSessions cria uma coleção de sessões de agente atuais. Esse método é fornecido para aplicativos cliente de Automação, como aqueles escritos no Visual Basic. Os aplicativos C e C++ devem usar o método EnumerateAgentSessions .

Sintaxe

HRESULT get_AgentSessions(
  [out] VARIANT *pVariant
);

Parâmetros

[out] pVariant

Ponteiro para VARIANT que contém uma ITCollection de ponteiros de interface ITAgentSession (objetos de sessão do agente).

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pVariant não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.

Comentários

O TAPI chama o método AddRef na interface ITAgentSession retornada por ITAgent::get_AgentSessions. O aplicativo deve chamar Release na interface ITAgentSession para liberar recursos associados a ele.