LINEAGENTSTATUS

typedef struct lineagentstatus_tag {
    DWORD  dwTotalSize;
    DWORD  dwNeededSize;
    DWORD  dwUsedSize;

    DWORD  dwNumEntries;
    DWORD  dwGroupListSize;
    DWORD  dwGroupListOffset;

    DWORD  dwState;
    DWORD  dwNextState;
    DWORD  dwActivityID;
    DWORD  dwActivitySize;
    DWORD  dwActivityOffset;

    DWORD  dwAgentFeatures;
    DWORD  dwValidStates;
    DWORD  dwValidNextStates;
} LINEAGENTSTATUS, FAR *LPLINEAGENTSTATUS;
 

Members

dwTotalSize

The total size in bytes allocated to this data structure.

dwNeededSize

The size in bytes needed to hold all the information requested.

dwUsedSize

The size in bytes of the portion of this data structure that contains useful information.

dwNumEntries

The number of LINEAGENTGROUPENTRY structures that appear in the GroupList array. The value is 0 if no agent is logged in on the address.

dwGroupListSize

dwGroupListOffset

Total size in bytes and offset from the beginning of LINEAGENTSTATUS of an array of LINEAGENTGROUPENTRY elements. The size is dwNumEntries times SIZEOF (LINEAGENTGROUPENTRY). The array contains groups into which the agent is currently logged in on the address.

dwState

The current state of the agent. One of the LINEAGENTSTATE_ constants.

dwNextState

The state into which the agent is automatically placed when the current call completes. One of the LINEAGENTSTATE_ constants.

dwActivityID

The identifier of the current agent activity.

dwActivitySize

dwActivityOffset

Size in bytes and offset from the beginning of LINEAGENTSTATUS of a NULL-terminated string specifying the current agent activity.

dwAgentFeatures

The agent-related features available at the time the status was obtained, using the LINEAGENTFEATURE_ constants.

dwValidStates

The agent states that could be selected, at this point in time, using lineSetAgentState. Consists of one or more of the LINEAGENTSTATE_ constants.

dwValidNextStates

The next agent states that could be selected, at this point in time, using lineSetAgentState. Consists of one or more of the LINEAGENTSTATE_ constants.

QuickInfo

  Version: Use TAPI version 2.0 and later
  Header: Declared in tapi.h.

See Also

LINEAGENTGROUPENTRY, lineSetAgentState