4.1.2.2 Response

  • Article

A protocol server returns a response message similar to the following:

 <?xml version="1.0" encoding="utf-8"?>
 <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
     <GetHostSharingCapabilitiesResponse 
   xmlns="http://schemas.microsoft.com/clouddocuments">
       <GetHostSharingCapabilitiesResult 
         xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <HostSharingCapabilities>
           <CustomMessageMaxLength>500</CustomMessageMaxLength>
           <DefaultsToTokenizedLinksInServerNotifications>false
           </DefaultsToTokenizedLinksInServerNotifications>
           <SupportedDocumentIdentifierTypes>
             <DocumentIdentifierType>WebUrl</DocumentIdentifierType>
           </SupportedDocumentIdentifierTypes> 
           <SupportedPermissionModes> 
             <PermissionMode>Strict</PermissionMode>
             <PermissionMode>Additive</PermissionMode>
           </SupportedPermissionModes>
           <SupportedRoles>
             <Role>Owner</Role>
             <Role>Edit</Role>
             <Role>View</Role>
             <Role>None</Role>
           </SupportedRoles>
           <SupportsCustomMessages>true</SupportsCustomMessages>
           <SupportsDisablingFeedNotifications>false</SupportsDisablingFeedNotifications>
           <SupportsDisablingServerNotifications>true
           </SupportsDisablingServerNotifications>
           <SupportsFeedNotifications>true</SupportsFeedNotifications>
           <SupportsNetworkSharing>false</SupportsNetworkSharing>
           <SupportsResettingTokenizedEditLinks>true</SupportsResettingTokenizedEditLinks>
           <SupportsResettingTokenizedViewLinks>true</SupportsResettingTokenizedViewLinks>
           <SupportsServerNotifications>true</SupportsServerNotifications>
           <SupportsTogglingOfLinkTypesInServerNotifications>true
           </SupportsTogglingOfLinkTypesInServerNotifications>
           <SupportsTokenizedEditLinks>true</SupportsTokenizedEditLinks>
           <SupportsTokenizedViewLinks>true</SupportsTokenizedViewLinks>
         </HostSharingCapabilities>
       </GetHostSharingCapabilitiesResult>
     </GetHostSharingCapabilitiesResponse>
   </s:Body>
 </s:Envelope>

In this example, the protocol server supports toggling link types in a server notification, so the protocol client could display an UI option to include tokenized sharing links in notifications.