Compartilhar via


Método ITAgentHandler::CreateAgent (tapi3.h)

O método CreateAgent cria um objeto Agent.

Sintaxe

HRESULT CreateAgent(
  [out] ITAgent **ppAgent
);

Parâmetros

[out] ppAgent

Ponteiro para a interface ITAgent .

Valor retornado

Esse método pode retornar um desses valores.

Valor Significado
S_OK
O método foi bem-sucedido.
E_OUTOFMEMORY
Existe memória insuficiente para executar a operação.
E_POINTER
O parâmetro ppAgent não é um ponteiro válido.
TAPI_E_TIMEOUT
A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

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

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tapi3.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

CreateAgentWithID

ITAgent

ITAgentHandler