4 Protocol Examples
Kendall Keil wants to see Ryan Gregg's calendar special folder. Kendall sends a sharing request to Ryan and Ryan responds.
The following is a description of what a client might do to accomplish this scenario and the responses a server might return. For details about the remote operations (ROPs) used in this example, see [MS-OXCPRPT] and [MS-OXCMSG].
Before manipulating Sharing Message objects, the client sends a RopGetPropertyIdsFromNames ROP request ([MS-OXCROPS] section 2.2.8.1) to ask the server to map each named property to a property ID. The following table lists each named property with its named property set GUID and its long ID (LID) or property name. The server's RopGetPropertyIdsFromNames ROP response provides the corresponding property IDs, as shown in the subsequent table.
|
Named property |
Property set GUID |
LID or property name |
|---|---|---|
|
PidNameContentClass (section 2.2.5.1) |
{00020386-0000-0000-c000-000000000046} |
Content-class |
|
PidLidSharingProviderGuid (section 2.2.2.12) |
{00062040-0000-0000-C000-000000000046} |
0x00008A01 |
|
PidNameXSharingProviderGuid (section 2.2.2.13) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Provider-GUID |
|
PidLidSharingProviderName (section 2.2.2.14) |
{00062040-0000-0000-C000-000000000046} |
0x00008A02 |
|
PidNameXSharingProviderName (section 2.2.2.15) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Provider-Name |
|
PidLidSharingProviderUrl (section 2.2.2.16) |
{00062040-0000-0000-C000-000000000046} |
0x00008A03 |
|
PidNameXSharingProviderUrl (section 2.2.2.17) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Provider-URL |
|
PidLidSharingConfigurationUrl (section 2.2.2.3) |
{00062040-0000-0000-C000-000000000046} |
0x00008A24 |
|
PidNameXSharingConfigUrl (section 2.2.2.4) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Config-URL |
|
PidLidSharingFlavor (section 2.2.2.5) |
{00062040-0000-0000-C000-000000000046} |
0x00008A18 |
|
PidNameXSharingFlavor (section 2.2.2.6) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Flavor |
|
PidLidSharingCapabilities (section 2.2.2.1) |
{00062040-0000-0000-C000-000000000046} |
0x00008A17 |
|
PidNameXSharingCapabilities (section 2.2.2.2) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Capabilities |
|
PidLidSharingLocalType (section 2.2.2.10) |
{00062040-0000-0000-C000-000000000046} |
0x00008A14 |
|
PidNameXSharingLocalType (section 2.2.2.11) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Local-Type |
|
PidLidSharingInitiatorEntryId (section 2.2.2.7) |
{00062040-0000-0000-C000-000000000046} |
0x00008A09 |
|
PidLidSharingInitiatorName (section 2.2.2.8) |
{00062040-0000-0000-C000-000000000046} |
0x00008A07 |
|
PidLidSharingInitiatorSmtp (section 2.2.2.9) |
{00062040-0000-0000-C000-000000000046} |
0x00008A08 |
|
PidLidSharingRemoteName (section 2.2.3.1) |
{00062040-0000-0000-C000-000000000046} |
0x00008A05 |
|
PidNameXSharingRemoteName (section 2.2.3.2) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Remote-Name |
|
PidLidSharingRemoteType (section 2.2.3.5) |
{00062040-0000-0000-C000-000000000046} |
0x00008A1D |
|
PidNameXSharingRemoteType (section 2.2.3.6) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Remote-Type |
|
PidLidSharingRemoteUid (section 2.2.3.7) |
{00062040-0000-0000-C000-000000000046} |
0x00008A06 |
|
PidNameXSharingRemoteUid (section 2.2.3.8) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Remote-Uid |
|
PidLidSharingRemoteStoreUid (section 2.2.3.3) |
{00062040-0000-0000-C000-000000000046} |
0x00008A48 |
|
PidNameXSharingRemoteStoreUid (section 2.2.3.4) |
{00020386-0000-0000-C000-000000000046} |
X-Sharing-Remote-Store-Uid |
|
PidLidSharingResponseType (section 2.2.4.2) |
{00062040-0000-0000-C000-000000000046} |
0x00008A27 |
|
PidLidSharingResponseTime (section 2.2.4.1) |
{00062040-0000-0000-C000-000000000046} |
0x00008A28 |
The server sends a RopGetPropertyIdsFromNames ROP response with the following property IDs, which will be used in the examples that follow. (The actual property IDs are at the discretion of the server.)
|
Property |
Property ID |
|---|---|
|
PidNameContentClass |
0x806D |
|
PidLidSharingProviderGuid |
0x8243 |
|
PidNameXSharingProviderGuid |
0x836F |
|
PidLidSharingProviderName |
0x8244 |
|
PidNameXSharingProviderName |
0x8370 |
|
PidLidSharingProviderUrl |
0x8245 |
|
PidNameXSharingProviderUrl |
0x8371 |
|
PidLidSharingConfigurationUrl |
0x83D0 |
|
PidNameXSharingConfigUrl |
0x8377 |
|
PidLidSharingFlavor |
0x823D |
|
PidNameXSharingFlavor |
0x836D |
|
PidLidSharingCapabilities |
0x823C |
|
PidNameXSharingCapabilities |
0x836C |
|
PidLidSharingLocalType |
0x824F |
|
PidNameXSharingLocalType |
0x8379 |
|
PidLidSharingInitiatorEntryId |
0x8249 |
|
PidLidSharingInitiatorName |
0x8029 |
|
PidLidSharingInitiatorSmtp |
0x8248 |
|
PidLidSharingRemoteName |
0x8026 |
|
PidNameXSharingRemoteName |
0x8373 |
|
PidLidSharingRemoteType |
0x8247 |
|
PidNameXSharingRemoteType |
0x8376 |
|
PidLidSharingRemoteUid |
0x8246 |
|
PidNameXSharingRemoteUid |
0x8374 |
|
PidLidSharingRemoteStoreUid |
0x83E1 |
|
PidNameXSharingRemoteStoreUid |
0x8375 |
|
PidLidSharingResponseType |
0x83E4 |
|
PidLidSharingResponseTime |
0x83E3 |