Meetings.GetMeetingsInformation Method

Lists the languages and templates supported by the specified server running Windows SharePoint Services. 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.

Namespace:  [Meetings Web service]
Web service reference: http://Site/_vti_bin/Meetings.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sharepoint/soap/meetings/GetMeetingsInformation", RequestNamespace := "http://schemas.microsoft.com/sharepoint/soap/meetings/",  _
    ResponseNamespace := "http://schemas.microsoft.com/sharepoint/soap/meetings/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function GetMeetingsInformation ( _
    requestFlags As UInteger, _
    lcid As UInteger _
) As XmlNode
'Usage
Dim instance As Meetings
Dim requestFlags As UInteger
Dim lcid As UInteger
Dim returnValue As XmlNode

returnValue = instance.GetMeetingsInformation(requestFlags, _
    lcid)
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sharepoint/soap/meetings/GetMeetingsInformation", RequestNamespace = "http://schemas.microsoft.com/sharepoint/soap/meetings/", 
    ResponseNamespace = "http://schemas.microsoft.com/sharepoint/soap/meetings/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode GetMeetingsInformation(
    uint requestFlags,
    uint lcid
)

Parameters

  • requestFlags
    Type: System.UInt32

    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
    Type: System.UInt32

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

Return Value

Type: System.Xml.XmlNode
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>"

Exceptions

Exception Condition
SoapException

If you include the canCreateMeetings flag in your request and post to a non-Meeting Workspace site, the following SOAP exception is 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 is "A Meeting Workspace site already exists at the location you specified. Specify a different location."

Remarks

The GetMeetingsInformation method allows you to retrieve a lot of information at once. To access the Meetings service and its methods, set a Web reference to http://Server_Name/[sites/][Site_Name/]_vti_bin/Meetings.asmx.

Examples

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

Private Sub MeetingInfo_Click(ByVal sender As System.Object, ByVal e As 
    System.EventArgs) Handles ListMWS.Click
 ws.Credentials = myCache.DefaultCredentials()
 ws.Url = ServerURLTextBox.Text
 If (ws.Url.EndsWith("/")) Then
  ws.Url = ws.Url.Remove(ws.Url.Length - 1, 1)
 End If

 ws.Url = ws.Url + "/_vti_bin/meetings.asmx"

 Dim GetMeetingInfoResponse As System.Xml.XmlNode

 If (ws.Url <> "") Then
  GetMeetingInfoResponse = 
    ws.GetMeetingsInformation(System.UInt32.Parse("1"), 
    System.UInt32.Parse("1033"))
 End If

 Dim OuterXml As String
 OuterXml = GetMeetingInfoResponse.OuterXml()
 MsgBox("OuterXml")
        
End Sub

SOAP Request Format   Following is a sample SOAP request. Replace the placeholders shown 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   Following is a sample SOAP response. Replace the placeholders shown with actual 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>

See Also

Reference

Meetings Class

Meetings Members

Meetings Web Service