Метод ITAgentHandler::CreateAgentWithID (tapi3cc.h)

Метод CreateAgentWithID создает объект агента на основе идентификатора агента. Этот идентификатор представляет собой строку, определяющую агент в устаревшей системе ACD. Если системе также требуется ПИН-код или пароль для входа в группы, используйте этот метод, чтобы задать ПИН-код или пароль.

Синтаксис

HRESULT CreateAgentWithID(
  [in]  BSTR    pID,
  [in]  BSTR    pPIN,
  [out] ITAgent **ppAgent
);

Параметры

[in] pID

Указатель на BSTR , содержащий идентификатор агента.

[in] pPIN

Указатель на BSTR , содержащий ПИН-код агента.

[out] ppAgent

Указатель на интерфейс ITAgent .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Значение
S_OK
Метод успешно выполнен.
E_INVALIDARG
Параметр pPIN имеет значение NULL.
E_POINTER
Параметр ppAgent не является допустимым указателем.
E_OUTOFMEMORY
Для выполнения операции недостаточно памяти.
TAPI_E_TIMEOUT
Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты.

Комментарии

Приложение должно использовать SysAllocString для выделения памяти для параметров pID и pPIN , а также использовать SysFreeString для освобождения памяти, когда переменные больше не нужны.

TAPI вызывает метод AddRef в интерфейсе ITAgent, возвращаемом ITAgentHandler::CreateAgentWithID. Приложение должно вызвать Release в интерфейсе ITAgent , чтобы освободить связанные с ним ресурсы.

Требования

   
Целевая платформа Windows
Header tapi3cc.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

См. также раздел

CreateAgent

ITAgent

ITAgentHandler