Meetings.GetMeetingsInformation Method
[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
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>"
| Exception type | Condition |
|---|---|
|
If you include the canCreateMeetings flag in your request and post to a non-Meeting Workspace site, the following SOAP exception is returned:
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." |
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.
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>
