Inside Microsoft® Exchange Server 2007 Web Services by David Sterling; Ben Spain; Michael Mainer; Mark Taylor; Huw Upshall Publisher: Microsoft Press Pub Date: November 28, 2007 Print ISBN-10: 0-7356-2392-9 Print ISBN-13: 978-0-7356-2392-7 Pages: 928 Table of Contents | Index Overview Dive deep into the architecture of Exchange Web Servicesand master the intricacies for accessing data with the new, unifying API Exchange Web Services offers new functionality, replacing old, disparate APIs This practical guide introduces developers to Exchange Web Services It includes comprehensive, in-depth coverage of the architecture and key features, including messaging, folders, calendaring, tasks, notifications, searching, availability, and autodiscovery Developers who are moving applications using previous APIs to Exchange Web Services will learn how to determine the correct web services constructsand the implications of those decisions This book assumes only knowledge of how to write HTTP requests, but it provides proxy examples in Microsoft Visual C# Inside Microsoft® Exchange Server 2007 Web Services by David Sterling; Ben Spain; Michael Mainer; Mark Taylor; Huw Upshall Publisher: Microsoft Press Pub Date: November 28, 2007 Print ISBN-10: 0-7356-2392-9 Print ISBN-13: 978-0-7356-2392-7 Pages: 928 Table of Contents | Index Copyright Acknowledgments Introduction Part I: The Basics Chapter 1 Welcome to Exchange Web Services What Is Exchange Web Services? Development Environment Schema Files Coding by Using Raw XML Summary Chapter 2 May I See Your Id? Accessing Your Own Mailbox Exchange Web Services Indentifiers Delegate Access Culture and Your Mailbox Summary Chapter 3 Property Paths and Response Shapes An Item by Any Other Name In Exchange Web Services, Properties Are King Get in Shape Relating Property Paths to Instance Element Names Change Keys and Shapes Summary Part II: Things in Your Mailbox Chapter 4 Folders Mailbox Structure Folder Types Folder Operations Managed Folders Summary Chapter 5 Items What Is an Item? Item Operations Summary Chapter 6 Contacts and Distribution Lists What Is a Contact? What Is a Distribution List? Creating a Contact Other Common Operations Contact Properties Creating a Distribution List Distribution List Properties Finding Store Contacts and Distribution Lists ResolveNames ExpandDL Summary Chapter 7 Messages What Exactly Is a Message? What Exactly Is a Recipient? The Disposition of a Message Message Properties Message Flags Sending Messages Replying To and Forwarding Messages Reports Summary Chapter 8 Working with Calendars Making the Complex Understandable Creating Your First Calendar Item Understanding Calendar Items Getting Adjacent and Conflicting Calendar Items Working with Date/Time Strings Working with Duration Strings Applying Best Practices to New CalendarItem Instances with the Proxy Classes Viewing Items on a Calendar Summary Chapter 9 Recurring Appointments and Time Zones Understanding Recurrences Creating a Recurring Series Updating a Recurring Series Working with Time Zones Summary Chapter 10 Scheduling Meetings Creating a Meeting and Inviting Attendees Working with Meeting Messages Registering a Meeting Response Working with Meeting Responses Cancelling Meetings Working with Recurring Meetings Summary Chapter 11 Tasks Basic Task Operations Task Properties Task Recurrence Summary Chapter 12 Attachments What Are Attachments? File Attachments Item Attachments Attachment Hierarchies Summary Chapter 13 Extended Properties A Little Background Extended Properties in Exchange Web Services Using Extended Properties Managed Folders MAPI Entry Ids Summary Part III: Searching Chapter 14 Searching the Mailbox Restrictions Search Expressions Special Considerations Summary Chapter 15 Advanced Searching Paging Grouped Item Queries Search Folders What Are Search Folders? How Are Search Folders Created? Retrieving Your Search Folder Updating Your Search Folder What Else Can Be Done Once Search Folders Are Created? Search Folders and the FindItem Operations The FindItem/SearchFolder Balancing Act Exchange Web Services Search Folder Quirks Summary Part IV: Keeping You in the Loop Chapter 16 Synchronization What Is Synchonization? Syncing the Folder Hierarchy Syncing Items Within a Folder Summary Chapter 17 Notification What Is a Notification? How Do Sync and Notification Differ? Pull Notifications Push Notifications Summary Part V: Advanced Topics Chapter 18 Errors Never Happen SOAP and Batch Processing The Normal Mechanism Response Messages Errors and the Proxy Classes HTTP 500 Status Codes Programming Consistency Batch Stop Processing Errors Summary Chapter 19 Server to Server Authentication The Two Hop Problem The Basic Principle Meet the Cast Types of S2S Authentication Requests Not All Methods Are Created Equal Going Back to IPS Summary Chapter 20 Autodiscover Talking to Autodiscover Autodiscover Providers Incorporating Autodiscover into Your Client Application Summary Chapter 21 Availability What Is User Availability? Understanding the GetUserAvailabilityRequest Understanding the GetUserAvailabilityResponse Working with TimeZone and MailboxData Properties in a GetUserAvailabilityRequest Working with Free/Busy Information Working with Suggestions Summary Chapter 22 Out Of Office Settings Introducing the SetUserOofSettings Web Method Introducing the GetUserOofSettings Method Summary About the Authors David Sterling Benjamin Spain Michael Mainer Mark Taylor Huw Upshall Additional Resources for Developers from Microsoft Press Visual Basic 2005 Visual C# 2005 Web Development Data Access SQL Server 2005 Other Developer Topics More Great Developer Resources from Microsoft Press Developer Step by Step Developer Reference Focused Topics Index Copyright PUBLISHED BY Microsoft Press A Division of Microsoft Corporation One Microsoft Way Redmond, Washington 98052-6399 Copyright © 2008 by Benjamin Spain, David Sterling, Huw Upshall, Mark Taylor, and Michael Mainer All rights reserved No part of the contents of this book may be reproduced or transmitted in any form or by any means without the written permission of the publisher Library of Congress Control Number: 2007934740 Printed and bound in the United States of America 1 2 3 4 5 6 7 8 9 QWT 2 1 0 9 8 7 Distributed in Canada by H.B Fenn and Company Ltd A CIP catalogue record for this book is available from the British Library Microsoft Press books are available through booksellers and distributors worldwide For further information about international editions, contact your local Microsoft Corporation office or contact Microsoft Press International directly at fax (425) 936-7329 Visit our Web site at www.microsoft.com/mspress Send comments to mspinput@microsoft.com Microsoft, Microsoft Press, Active Directory, ActiveSync, ActiveX, Expression, Front Page, IntelliSense, Internet Explorer, MSDN, Outlook, Visual Studio, Win32, Windows, Windows NT, and Windows PowerShell are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries Other product and company names mentioned herein may be the trademarks of their respective owners The example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred This book expresses the author's views and opinions The information contained in this book is provided without any express, statutory, or implied warranties Neither the authors, Microsoft Corporation, nor its resellers, or distributors will be held liable for any damages caused or alleged to be caused either directly or indirectly by this book Acquisitions Editor: Ben Ryan Developmental Editor: Devon Musgrave Project Editor: Victoria Thulman Editorial Production: Custom Editorial Productions, Inc Technical Reviewers: Christopher Simison and Bob Dean Body Part No X14-06310 Dedication This book is dedicated to my lovely wife, Rie I could ask for no better partner in life Thank you for all your time, love, and dedication I am truly a rich man as a result I love you —David To Stacey: You convince me more and more each day that I have found the perfect partner in life Here is to our years past, and to many, many more To Isaiah: Daddy is very proud of you, and you have inspired me more then you will ever know Now, let's go find those race cars! —Ben proxy classes for security descriptor for security identifier (SID) in Windows logon and Mailbox account in overview of Service account in to retrieve WSDL file Token Serialization in two hop problem in Server-side parsing Service account Service Principal Name (SPN) Services For You (S4U) logon privileges SetFolderFieldType 2nd 3rd SetItemField element change descriptions for 2nd for read receipts for scheduling meetings ItemChanges element and 2nd 3rd SetUserOofSettings Web method Mailbox element in proxy classes for response to UserOofSettings element in Shapes [See also Response shapes] default 2nd folder 2nd for attachments for extended properties for search folders IdOnly base ItemType properties and SilentUpdate meeting requests Simple Mail Transfer Protocol (SMTP) addresses in Autodiscover and Contains filter and for meeting messages PrimarySmtpAddress and 2nd proxy addresses for recipient addresses and 2nd syntactically invalid Simple Object Access Protocol (SOAP) service NET framework and Act As account SID in header of error messages in errors as exceptions in Exchange Impersonator in header of 2nd fault messages of in HTTP POST requests in MailboxCultureSOAP header 2nd 3rd search folders and sending requests in Simple type restrictions Single calendar item SingleRecipientType wrapper SmartResponseType properties 2nd Soft deleting 2nd 3rd Software development kit (SDK) Solution Explorer 2nd SortOrder element Source folders Specified flags Stale data 2nd 3rd StampItemWithInspectorState Standard ranges for property tags Standard time 2nd 3rd Start property for calendars 2nd 3rd 4th 5th 6th 7th StartDate property for tasks StartTime element 2nd 3rd 4th StatusDescription property of tasks 2nd StatusEvent responses StatusFrequency element 2nd Store contacts e-mail addresses for finding ItemId element and overview of resolving retrieving Store distribution list 2nd Streamable properties String properties ArrayofStringsType of 2nd enumeration values and MIME and streamable Strongly typed folders Subject property for calendars for contacts in searching of messages Subscriptions pull notification 2nd push notification SubscriptionId element for 2nd SubstringContainmentMode Success, as FreeBusyResponse Suffix matching Suggestions date picker control for definition of ExcludeConflicts element and GetUserAvailabilityRequest Web method and 2nd GetUserAvailabilityResponse Web method and 2nd in Availability request in Availability response proxy to get Suggestion element for SuggestionsResponse for SuggestionsView Options elements in time zone issues with Suppressing read receipts 2nd SyncFolderHierarchy Web method folder shapes in overview of responses to SyncState element and SyncFolderId element SyncFolderItems Web method Synchronization [See also Autodiscover] definition of id caching and in folder hierarchy "other" delete for Changes element for FolderShape element for IncludesLastFolderInRange element for moving and copying and omissions in responses to SyncFolderHierarchy responses to SyncShape element for notification versus of items in folders Ignore element for ItemShape element for MaxChangesReturned element for SyncFolderId element for SyncFolderItems responses to SyncState element for of items outside IPM subtree System.Convert class System.Convert.FromBase64String System.DateTime object 2nd 3rd System.Object property type System.TimeSpan object System.Web namespace System.Xml namespace SystemInvalidCastException SystemTime type Index [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] TargetFolderIdType 2nd Tasks basic operations of folders for 2nd properties of AssignedTime delegation DelegationState Delegator IsAssignmentEditable IsComplete and PercentComplete IsTeamTask list of Owner Status and StatusDescription recurring creating modifying overdue regenerating regenerating pattern of relationships among restrictions and properties of TaskType of item TechNet forums Templates, class library Tentatively accepting meetings Text messaging "Thread" view Time element [See also Calendars, Recurrences, TimeZone element] TimeChangeType Timeout element TimeSpan strucutures Timestamp element TimeWindow element TimeZone element availability request requirement for Bias element of CalendarEvents and DayOrder, Month, and DayOfWeek elements of for calendars 2nd 3rd 4th GetUserAvailabilityRequest Web method and in recurrence ranges MeetingTimeZone element and of WorkingHours element proxy classes for setting RelativeYearlyRecurrencePatternType versus setting StandardTime and DaylightTime in Suggestions and Time element of updating XML serialization issues and TNEF encoding ToBase64String method ToFolderId element Token Serialization TooBigGroupdAttendeeConflictData element ToRecipients collection 2nd 3rd 4th 5th 6th TotalCount property for calendars TotalItemsInView 2nd 3rd 4th TotalWork property for tasks Trailing 'Z' character in xs.dateTime strings 2nd Transversal attribute 2nd 3rd Two-hop problem TwoOperand expression 2nd Types BaseFolder 2nd Item namespace for reference value 2nd Types.xsd Index [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] Unicode values Unindexed property paths 2nd 3rd UnindexedFieldURIType 2nd Unions, as XSD construct UnknownAttendeeConflictData element UnreadCount property 2nd UnresolvedEntry element, contacts and UpdateFolder method 2nd UpdateItem Web method 2nd change keys for ConflictResolution attribute in for calendars for contacts for IsComplete task property for read receipts for recipient collection properties for recurring meetings for recurring tasks incorrect specification in ItemChanges element and MessageDisposition attribute and SavedItemFolderId element and to schedule meetings with SendAndSaveOnly value Updating change entries 2nd extended properties recurrences search folders time zones URL element User element User parameter User principal name (UPN) UserOofSettings element UTC [See Coordinated Universal Time (UTC)] UTF-8 coding Index [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] Validation of requests Value types 2nd Values [See Enumeration values] van der Vlist, Eric Variable interval recurrences 2nd absolute month daily interval property for relative month weekly VB.net proxy Version control Visible attachments Visual Studio "standard" Web service programming in Command Prompt of proxy generation by Visual Studio IntelliSense Voicemail, folder for 2nd Index [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] W3C (World Wide Web Consortium) 2nd Watermark response element 2nd Web Distributed Authoring and Versioning (WebDAV) Web Services Description Language (WSDL) AutoDiscover and proxy generation by server to server authentication and Services.wsdl in Weekly recurrences 2nd WellKnownResponseObjectType When property 2nd Win32 API Windows PowerShell WinForms application Word matches Workflows, meeting 2nd 3rd WorkingHours element 2nd 3rd 4th WorkingPeriod elements Wrappers Index [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] XML [See also Proxy classes, Simple Object Access Protocol (SOAP) service] Autodiscover and character data (CDATA) blocks and choice elements and for coding Content element and DateTime structure and element name for expressive schema in extended property paths in ExtendedFieldTypeURI in folders in for FindItem Web method for recurrence ranges in Items node IndexedFieldURI in instance documents of item representation in MessageXml element and 2nd Plain Old pull notification request in serialization attributes of 2nd time zones and TwoOperandExpressionType and unindexed property paths in WSDL file in Xml elements 2nd "XML Schema Part 2 Data Types" (W3C) 2nd "XML Schema" (van der Vlist) XmlChoiceIdentificationAttribute attribute XmlConvert.ToString method XmlEnumAttribute attribute XmlRoot attribute XmlSerializer XPath query xs date dateTime 2nd time 2nd XSD constructs xsi type attribute Index [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] 'Z' character in xs.dateTime strings 2nd Zero duration ... by visiting the sites just listed, please send them to Microsoft Press via e-mail to mspinput @microsoft. com Or via postal mail to Microsoft PressAttn: Inside Microsoft Exchange Server 2007 Web Services One Microsoft Way Redmond, WA 98052-6399.. .Inside Microsoft? ? Exchange Server 2007 Web Services by David Sterling; Ben Spain; Michael Mainer; Mark Taylor; Huw Upshall Publisher: Microsoft Press Pub Date: November 28, 2007 Print ISBN- 10: 0-7356-2392-9... other members that make up the Exchange Web Services team It is our goal that you will not only understand how to program on Exchange using Exchange Web Services, but also why the Exchange Web Services team designed it the way they did