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

아티클
08/26/2023

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를 호출하여 연결된 리소스를 해제해야 합니다.