GetMeetingsInformation Method

Article
03/25/2009

The GetMeetingsInformation method of the Meetings service lists the languages and templates supported by the specified Microsoft Windows SharePoint Services server. It also specifies whether the caller has the ManageSubweb right on the Meeting Workspace site and shows other workspace settings, such as Anonymous Access, Unique Permissions, the meeting count, and AllAuthenticatedUsers.

Parameters

requestFlags Can be one or more of the following flags OR-ed together:

canCreateMeetings (returns true or false to indicate whether the caller has ManageSubweb rights on the site being posted to)
templateLanguages (returns the list of languages for which templates are available)
templateList (returns the list of available Meeting Workspace templates available for the specified LCID)
workspacestatus (returns information about the workspace)

For example, setting this parameter to 1 turns on the first bit, which returns whether you have the permission to create a meeting. Setting the parameter to 2 turns on the second bit, which returns the list of available template languages. Setting it to 3 turns on both the first and second bit and returns both sets of information.

lcid The LCID (locale identifier) to which you want to limit the results.

Return Value

A Microsoft.SharePoint.SoapServer.SoapXml that contains the following:

<MeetingsInformation>
    <AllowCreate>True</AllowCreate>
    <ListTemplateLanguages><LCID>1033</LCID></ListTemplateLanguages>
    <ListTemplates>
        <Template Name="MPS#0" Title="Basic Meeting Workspace" Id="2" Description="All the basics to plan, organize and track your meeting.  This Meeting Workspace contains the following lists:  Objectives, Attendees and Agenda." ImageUrl="http://sturton2g/_layouts/1033/images/basic.gif" />
        <Template Name="MPS#1" Title="Blank Meeting Workspace" Id="2" Description="A blank Meeting Workspace for you to customize based on your requirements." ImageUrl="http://sturton2g/_layouts/1033/images/blank.gif" />
        <Template Name="MPS#2" Title="Decision Meeting Workspace" Id="2" Description="A Meeting Workspace in which to review relevant documents and record decisions.  This Meetings Workspace contains the following lists:  Objectives, Attendees, Agenda, Document Libraries, Tasks and Decisions." ImageUrl="http://sturton2g/_layouts/1033/images/decision.gif" />
        <Template Name="MPS#3" Title="Social Meeting Workspace" Id="2" Description="A planning tool for social occasions, featuring a discussion board and a picture library to post pictures of the event.  This Meeting Workspace contains the following lists and webparts: Attendees, Directions, Weather, Image/Logo, Things To Bring, Discussions and a Picture Library." ImageUrl="http://sturton2g/_layouts/1033/images/social.gif" />
        <Template Name="MPS#4" Title="Multipage Meeting Workspace" Id="2" Description="All the basics to plan, organize and track your meeting with multiple pages.  This Meeting Workspace contains the following lists:  Objectives, Attendees and Agenda in addition to two blank pages for you customize based on your requirements." ImageUrl="http://sturton2g/_layouts/1033/images/training.gif" />
    </ListTemplates>
    <WorkspaceStatus UniquePermissions="true" MeetingCount="0" AnonymousAccess="false" AllowAuthenticatedUsers="false" />
</MeetingsInformation>"

Remarks

The GetMeetingsInformation method allows you to retrieve a a lot of information at once.

Exceptions

If you include the canCreateMeetings flag in your request and you post to a non Meeting Workspace site, the following SOAP exception will be returned:

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <soap:Body>

    <soap:Fault>

      <faultcode>soap:Server</faultcode>

      <faultstring>Exception of type Microsoft.SharePoint.SoapServer.SoapServerException was thrown.</faultstring>

      <detail>

        <errorstring xmlns="http://schemas.microsoft.com/sharepoint/soap/">Your attempt to delete a Meeting Workspace site could not be completed. The specified location is not a Meeting Workspace site..</errorstring>

        <errorcode xmlns="http://schemas.microsoft.com/sharepoint/soap/">0x00000004</errorcode>

      </detail>

    </soap:Fault>

  </soap:Body>

</soap:Envelope>

The error code will be 0x00000001, and the errorstring will be "A Meeting Workspace site already exists at the location you specified. Specify a different location."

Example

The following code returns the meeting information from the server. Note that ServerURLTextBox is an interface element that is on a form in the Visual Basic .Net project.

SOAP Request Format

The following is a sample SOAP request. The placeholders shown need to be replaced with actual values.

POST /_vti_bin/meetings.asmx HTTP/1.1
Host: server_name
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://schemas.microsoft.com/sharepoint/soap/meetings/GetMeetingsInformation"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetMeetingsInformation xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <requestFlags>unsignedInt</requestFlags>
      <lcid>unsignedInt</lcid>
    </GetMeetingsInformation>
  </soap:Body>
</soap:Envelope>

SOAP Response Format

The following is a sample SOAP response. The placeholders shown will be replaced with actual return values.

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetMeetingsInformationResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/meetings/">
      <GetMeetingsInformationResult>
        <xsd:schema>schema</xsd:schema>xml</GetMeetingsInformationResult>
    </GetMeetingsInformationResponse>
  </soap:Body>
</soap:Envelope>

Requirements

Platforms: Microsoft Windows Server 2003

Web Reference: http://Server_Name/[sites/][Site_Name/]_vti_bin/Meetings.asmx

Share via