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("https://schemas.microsoft.com/sharepoint/soap/meetings/GetMeetingsInformation", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/meetings/", _
ResponseNamespace := "https://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("https://schemas.microsoft.com/sharepoint/soap/meetings/GetMeetingsInformation", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/meetings/",
ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/meetings/",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode GetMeetingsInformation(
uint requestFlags,
uint lcid
)
Parameters
requestFlags
Type: System.UInt32Can 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.UInt32The 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="https://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= "https://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="https://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 https://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: "https://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="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetMeetingsInformation xmlns=
"https://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="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetMeetingsInformationResponse xmlns=
"https://schemas.microsoft.com/sharepoint/soap/meetings/">
<GetMeetingsInformationResult>
<xsd:schema>schema</xsd:schema>xml
</GetMeetingsInformationResult>
</GetMeetingsInformationResponse>
</soap:Body>
</soap:Envelope>