ITAgent::CreateSessionWithPIN 메서드(tapi3cc.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
헤더	tapi3cc.h(Tapi3.h 포함)
라이브러리	Uuid.lib
DLL	Tapi3.dll

추가 정보

ITAgent

ITAgent::CreateSession

ITAgentSession