Platform SDK: TAPI

LINE_AGENTSTATUS

The TAPI LINE_AGENTSTATUS message is sent when the status of an ACD agent changes on a line the application currently has open. The application can invoke lineGetAgentStatus to determine the current status of the agent.

LINE_AGENTSTATUS
hDevice = (DWORD) hLine;
dwCallbackInstance = (DWORD) dwInstanceData;
dwParam1 = (DWORD) dwAddressID;
dwParam2 = (DWORD) AgentStatus;
dwParam3 = (DWORD) AgentStatusDetail;

Parameters

hDevice
The application's handle to the line device on which the agent status has changed.
dwCallbackInstance
The callback instance supplied when opening the call's line.
dwParam1
Identifier of the address on the line on which the agent status changed. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.
dwParam2
Specifies the agent status that has changed; can be a combination of LINEAGENTSTATUS_ constants.
dwParam3
If dwParam2 includes the LINEAGENTSTATUS_STATE bit, then dwParam3 indicates the new value of the dwState member in LINEAGENTSTATUS. Otherwise, this parameter is set to zero.

Return Values

No return value.

Remarks

The LINE_AGENTSTATUS message is not sent to applications that support older versions of TAPI.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tapi.h.

See Also

LINEAGENTSTATUS, lineGetAgentStatus