ITAgent::get_ID method (tapi3cc.h)

The get_ID method gets an agent's ID.

Syntax

HRESULT get_ID(
  [out] BSTR *ppID
);

[out] ppID

Pointer to BSTR containing agent ID.

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
TAPI_E_CALLCENTER_NO_AGENT_ID	ITAgent was not created using ITAgentHandler::CreateAgentWithID, but with ITAgentHandler::CreateAgent. No ID exists.
E_POINTER	The ppID parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

This method is provided for interfacing with legacy switch solutions.

The application must free the memory allocated for the ppID parameter through SysFreeString when the variable is no longer needed.