ffffiirrss..iinndddd iiii 44//2255//1111 44::3311::1133 PPMM PROFESSIONAL UNIFIED COMMUNICATIONS DEVELOPMENT WITH MICROSOFT® LYNC™ SERVER 2010 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv CHAPTER 1 Building Communications Solutions with Microsoft Lync Server 2010 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 CHAPTER 2 Integrating Microsoft Lync Functionality into Your Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 CHAPTER 3 Building Communications Clients with the Microsoft Lync 2010 Managed API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 CHAPTER 4 Adding Context to Conversations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 CHAPTER 5 Building Custom Communications Clients with Lync UI Suppression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 CHAPTER 6 Introduction to the Unifi ed Communications Managed API . . . . . . . . . 145 CHAPTER 7 Starting Up and Shutting Down a UCMA Application . . . . . . . . . . . . . . .171 CHAPTER 8 Two -P arty Call Control with UCMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209 CHAPTER 9 Presence with UCMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263 CHAPTER 10 Contact and Group Services in UCMA . . . . . . . . . . . . . . . . . . . . . . . . . . .287 CHAPTER 11 Conference Services in UCMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307 CHAPTER 12 Advanced Media Control in UCMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353 CHAPTER 13 Debugging UCMA Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .407 CHAPTER 14 Building Communications- Enabled Business Processes with the UCMA 3.0 Workfl ow SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .429 INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 ffffiirrss..iinndddd ii 44//2255//1111 44::3311::1122 PPMM ffffiirrss..iinndddd iiii 44//2255//1111 44::3311::1133 PPMM PROFESSIONAL Unifi ed Communications Development with Microsoft® Lync™ Server 2010 ffffiirrss..iinndddd iiiiii 44//2255//1111 44::3311::1133 PPMM ffffiirrss..iinndddd iivv 44//2255//1111 44::3311::1144 PPMM PROFESSIONAL Unifi ed Communications Development with Microsoft® Lync™ Server 2010 George Durzi Michael Greenlee o D ffffiirrss..iinndddd vv 44//2255//1111 44::3311::1144 PPMM Professional Unifi ed Communications Development with Microsoft® Lync™ Server 2010 Published by Wiley Publishing, Inc. 10475 Crosspoint Boulevard Indianapolis, IN 46256 www.wiley.com Copyright © 2011 by Wiley Publishing, Inc., Indianapolis, Indiana Published simultaneously in Canada ISBN: 978-0-470-93903-1 ISBN: 978-1-118-11650-0 (ebk) ISBN: 978-1-118-11396-7 (ebk) ISBN: 978-1-118-11397-4 (ebk) Manufactured in the United States of America 10 9 8 7 6 5 4 3 2 1 No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except as permitted under Sections 107 or 108 of the 1976 United States Copyright Act, without either the prior written permission of the Publisher, or authorization through payment of the appropriate per-copy fee to the Copyright Clearance Center, 222 Rosewood Drive, Danvers, MA 01923, (978) 750-8400, fax (978) 646-8600. Requests to the Publisher for permission should be addressed to the Permissions Department, John Wiley & Sons, Inc., 111 River Street, Hoboken, NJ 07030, (201) 748-6011, fax (201) 748-6008, or online at http://www.wiley.com/go/permissions. Limit of Liability/Disclaimer of Warranty: The publisher and the author make no representations or warranties with respect to the accuracy or completeness of the contents of this work and specifi cally disclaim all warranties, including without limitation warranties of fi tness for a particular purpose. No warranty may be created or extended by sales or promotional materials. The advice and strategies contained herein may not be suitable for every situation. This work is sold with the understanding that the publisher is not engaged in rendering legal, accounting, or other professional services. If professional assistance is required, the services of a competent professional person should be sought. Neither the publisher nor the author shall be liable for damages arising herefrom. The fact that an organization or Web site is referred to in this work as a citation and/or a potential source of further information does not mean that the author or the publisher endorses the information the organization or Web site may provide or recommendations it may make. Further, readers should be aware that Internet Web sites listed in this work may have changed or disappeared between when this work was written and when it is read. For general information on our other products and services please contact our Customer Care Department within the United States at (877) 762-2974, outside the United States at (317) 572-3993 or fax (317) 572-4002. Wiley also publishes its books in a variety of electronic formats. Some content that appears in print may not be available in electronic books. Library of Congress Control Number: 2011926919 Trademarks: Wiley, the Wiley logo, Wrox, the Wrox logo, Wrox Programmer to Programmer, and related trade dress are trademarks or registered trademarks of John Wiley & Sons, Inc. and/or its affi liates, in the United States and other countries, and may not be used without written permission. Microsoft and Lync are trademarks or registered trademarks of Microsoft Corporation. All other trademarks are the property of their respective owners. Wiley Publishing, Inc., is not associated with any product or vendor mentioned in this book. ffffiirrss..iinndddd vvii 44//2255//1111 44::3311::1144 PPMM To my wife Amy, my parents Victor and Juliette, and my siblings Mark and Tamara. I love you. — George To my father. —M ichael ffffiirrss..iinndddd vviiii 44//2255//1111 44::3311::1155 PPMM ffffiirrss..iinndddd vviiiiii 44//2255//1111 44::3311::1155 PPMM