Platform SDK: TAPI

ITAgent::get_ID

Gets an agent's ID.

HRESULT get_ID(
  BSTR *ppID
);

Parameters

ppID
[out, retval] Pointer to BSTR containing agent ID.

Return Values

Value Meaning
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.

Remarks

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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITAgent