다음을 통해 공유

ITAgentHandler::CreateAgentWithID 메서드(tapi3.h)

  • 아티클

CreateAgentWithID 메서드는 에이전트 식별자를 기반으로 에이전트 개체를 만듭니다. 이 식별자는 레거시 ACD 시스템에서 에이전트를 식별하는 문자열입니다. 시스템에 그룹에 로그인하기 위해 PIN 또는 암호도 필요한 경우 이 메서드를 사용하여 PIN 또는 암호를 설정합니다.

구문

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

매개 변수

[in] pID

에이전트 식별자를 포함하는 BSTR 에 대한 포인터입니다.

[in] pPIN

에이전트 PIN을 포함하는 BSTR 에 대한 포인터입니다.

[out] ppAgent

ITAgent 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값 의미
S_OK
 메서드가 정상적으로 실행되었습니다.
E_INVALIDARG
 pPIN 매개 변수는 NULL입니다.
E_POINTER
 ppAgent 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
 메모리가 부족하여 작업을 수행할 수 없습니다.
TAPI_E_TIMEOUT
 TAPI 3 DLL의 시간이 초과되어 작업이 실패했습니다. 시간 제한 간격은 2분입니다.

설명

애플리케이션은 SysAllocString을 사용하여 pID 및 pPIN 매개 변수에 대한 메모리를 할당하고, 변수가 더 이상 필요하지 않을 때 SysFreeString을 사용하여 메모리를 해제해야 합니다.

TAPI는 ITAgentHandler::CreateAgentWithID에서 반환된 ITAgent 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITAgent 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi3.h(Tapi3.h 포함)
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

CreateAgent

ITAgent

ITAgentHandler