ListConnectedVisitors Message

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Gets a report of the visitors connected to a meeting in progress.

Components

Component Type

XML Element

Request

ListConnectedVisitorsRequest

Reply

ListConnectedVisitorsReply

Remarks

This message can be used to obtain a list of connected visitors before a DisconnectVisitors message is called.

A caller must be a member of the Administrator role or be the Organizer that owns the meeting.

Examples

The following example shows how to discover who connected to the "strategy" meeting within the specified time interval and is still connected to the meeting right now. The name of a visitor and vid is returned.

The following code shows the request sent to a conference center.

<PlaceWareConfCenter authUser="apiuser" authPassword="Pa$$w0rd">
  <ListConnectedVisitorsRequest>
    <StringQuery fieldName="name" operator="=" value="strategy"/>
    <TimeIntervalQuery fieldName="startTime">
      <TimeInterval startTime="2007-01-01T18:00:00Z"
                    endTime="2007-01-01T19:00:00Z"/>
    </TimeIntervalQuery>
    <FieldList>
      <Name>userName</Name>
      <Name>vid</Name>
    </FieldList>
  </ListConnectedVisitorsRequest>
</PlaceWareConfCenter>

The following shows the reply from the conference center.

<PlaceWareConfCenter>
  <ListConnectedVisitorsReply>
    <Visitor>
      <OptionList>
        <StringOption name="userName" value="DonH"/>
        <StringOption name="vid" value="053zpdsncktlrr"></StringOption>
      </OptionList>
    </Visitor>
    <Visitor>
      <OptionList>
        <StringOption name="userName" value="MarkH"/>
        <StringOption name="vid" value="nhz53qlw86rf6xw"/>
      </OptionList>
    </Visitor>
    <Visitor>
      <OptionList>
        <StringOption name="userName" value="MaryB"/>
        <StringOption name="vid" value="mdk53wps73ht5fj"/>
      </OptionList>
    </Visitor>
   </ListConnectedVisitorsReply>
</PlaceWareConfCenter>

See Also

Concepts

ListConnectedVisitorsRequest Element

ListConnectedVisitorsReply Element