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

아티클
03/05/2024

CreateSession 메서드는 입력 ACD 그룹 및 주소에 대한 새 에이전트 세션을 만듭니다.

구문

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

매개 변수

[in] pACDGroup

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

[in] pAddress

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

[out] ppAgentSession

만든 개체에 대한 ITAgentSession 인터페이스에 대한 포인터입니다.

반환 값

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

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

설명

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

일부 전화 환경에서는 세션을 열려면 개인 ID 번호가 필요합니다. CreateSessionWithPIN을 참조하세요.