ITAgent::CreateSessionWithPIN 메서드(tapi3.h)

  • 아티클

CreateSessionWithPIN 메서드는 PIN(개인 식별 번호)을 사용하여 입력 ACD 그룹 및 주소에 대한 새 에이전트 세션을 만듭니다.

구문

HRESULT CreateSessionWithPIN(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [in]  BSTR           pPIN,
  [out] ITAgentSession **ppAgentSession
);

매개 변수

[in] pACDGroup

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

[in] pAddress

ACD 호출을 수신하는 데 사용할 수 있는 개체에 대한 ITAddress 인터페이스에 대한 포인터입니다.

[in] pPIN

에이전트 PIN의 BSTR 표현에 대한 포인터입니다.

[out] ppAgentSession

만든 세션에 대한 포인터입니다.

반환 값

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

값 의미
S_OK
 메서드가 정상적으로 실행되었습니다.
TAPI_E_CALLCENTER_NO_AGENT_ID
 CreateAgentWithID에서 생성되지 않은 에이전트입니다.
TAPI_E_TIMEOUT
 TAPI 3 DLL의 시간이 초과되어 작업이 실패했습니다. 시간 제한 간격은 2분입니다.
E_INVALIDARG
 pPIN 은 NULL입니다.
E_POINTER
 pPIN 또는 ppAgentSession 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
 작업을 수행하기 위한 메모리가 부족합니다.

설명

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

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

요구 사항

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

추가 정보

ITAgent

ITAgent::CreateSession

ITAgentSession