共用方式為

ITAgent：：CreateSessionWithPIN 方法 (tapi3.h)

  • 發行項

CreateSessionWithPIN方法會為輸入 ACD 群組和位址建立新的代理程式會話，並使用個人識別碼 (PIN) 。

語法

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 已逾時。逾時間隔為兩分鐘。
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