MAPI,SAPI,and TAPI Developer's Guide(NO.1)

All rights reserved. No part of this book shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without written permission from the publisher. No patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this book, the publisher and author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. For information, address Sams Publishing, 201 W. 103rd St., Indianapolis, IN 46290.

International Standard Book Number: 0-672-30928-9

HTML conversion by :
    M/s. LeafWriters (India) Pvt. Ltd.
    Website : http://leaf.stpn.soft.net
    e-mail : leafwriters@leaf.stpn.soft.net

Trademarks

All terms mentioned in this book that are known to be trademarks or service marks have been appropriately capitalized. Sams Publishing cannot attest to the accuracy of this information. Use of a term in this book should not be regarded as affecting the validity of any trademark or service mark.

President and Publisher	Richard K. Swadley
Publishing Team Leader	Greg Wiegand
Managing Editor	Cindy Morrow
Director of Marketing	John Pierce
Assistant Marketing Managers	Kristina Perry, Rachel Wolfe

Acquisitions Editor	Sharon Cox	Development Editor	Tony Amico, Andrew Fritzinger
Software Development Specialist	Steve Straiger	Production Editor	Mary Ann Faughnan
Indexer	Chris Barrick	Technical Reviewer	John Charlesworth
Editorial Coordinator	Bill Whitmer	Technical Edit Coordinator	Lynette Quinn
Resource Coordinator	Deborah Frisby	Editorial Assistants	Carol Ackerman, Andi Richter, Rhonda Tinch-Mize
Cover Designer	Tim Amrhein	Book Designer	Alyssa Yesh
Copy Writer	Peter Fuller	Production Team Supervisor	Brad Chinn
Production	Stephen Adams, Debra Bolhuis, Mona Brown, Michael Dietsch, Jason Hand, Daniel Harris, Susan Knose, Casey Price, Laura Robbins, Susan Van Ness

Acknowledgments

Putting this book together took lots of help from many talented people. Although I can't list them all, I want to take a moment to single out a few of the individuals who made this work possible.

First, I want to thank Jefferson Schuler and Bill Zembrodt of Pioneer Solutions. They accepted my challenge to build a simple TAPI OCX tool that would allow Visual Basic programmers virtually the same access to Microsoft's Telephony API services as C++ programmers. The result is the TAPILINE.OCX that is included on the CD-ROM that accompanies this book. They spent several long days and late nights developing this handy tool and I thank them for all their work and assistance.

Next, I must thank all those in cyberspace who answered my queries about telephony, speech systems, and electronic mail. Many of the concepts that appear in this book were hashed out in extensive messages over the Internet, and I thank all those who assisted me in my efforts. I could name many who helped, but I will refrain from doing so lest they be blamed for any of my mistakes within these pages.

I also want to thank the people at Sams Publishing. It takes a great number of talented individuals to get a book from the idea stage to the store shelves, and I consider it a privilege to be able to work with the folks at Sams. Completing this book took more time and effort than any of us originally suspected and more than once it seemed like the book would never be done. I am especially indebted to Sharon Cox for her continued help and support. I doubt this book would be in your hands today were it not for her assistance.

Finally, I need to acknowledge the special contributions made by my family. Without their support, patience, and understanding, I could not have completed this book. (And now that I have completed it, I have a long list of promises that I must live up to!)

About the Author

Mike Amundsen works as an IS consulting and training specialist for Design-Synergy Corporation, a consulting and project management firm specializing in information technology services. He has earned Microsoft certifications for Windows operating systems, Visual Basic, SQL Server, and Microsoft Exchange Server. Mike's work takes him to various locations in the U.S. and Europe where he teaches Windows programming and helps companies develop and manage Windows-based client/server solutions.

He is co-author of Teach Yourself Database Programming with Visual Basic 4 in 21 Days, published by Sams, and was a contributing author for Visual Basic 4 Unleashed and Visual Basic 4 Developer's Guide from Sams Publishing. Mike is the contributing editor for Cobb's "Inside Visual Basic for Windows" newsletter, and his work has been published in "Visual Basic Programmer's Journal" magazine, "VB Tech" magazine, and "Access Developer's Journal."

When he's not busy writing or traveling to client sites, Mike spends time with his family at his home in Kentucky. You may write to Mike at his CompuServe address 102461,1267, at MikeAmundsen@msn.com on the Internet, or you can visit his Web site at www.iac.net/~mamund/.

Tell Us What You Think!

As a reader, you are the most important critic and commentator of our books. We value your opinion and want to know what we're doing right, what we could do better, what areas you'd like to see us publish in, and any other words of wisdom you're willing to pass our way. You can help us make strong books that meet your needs and give you the computer guidance you require.

Do you have access to CompuServe or the World Wide Web? Then check out our CompuServe forum by typing GO SAMS at any prompt. If you prefer the World Wide Web, check out our site at http://www.mcp.com.

Note

If you have a technical question about this book, call the technical support line at (800) 571-5840, ext. 3668.

As the team leader of the group that created this book, I welcome your comments. You can fax, e-mail, or write me directly to let me know what you did or didn't like about this book-as well as what we can do to make our books stronger. Here's the information:

FAX:	317/581-4669
E-mail:	`programming_mgr@sams.mcp.com`
Mail:	Greg Wiegand Comments Department Sams Publishing 201 W. 103rd Street Indianapolis, IN 46290

Introduction to MAPI, SAPI, and TAPI Developer's Guide

This book covers the three most exciting programming services available on the Microsoft Windows platform-messaging (MAPI), speech (SAPI), and telephony (TAPI). Each of these APIs provides a specialized set of services that expand the reach of the Windows operating system in a way that makes it easier to write programs that work without having to deal with the differences between hardware provided from third parties.

The addition of these services as part of the basic operating system not only is a boon to programmers-it is of great interest to users, too. Computers that can handle messages and telephones, and that can generate and understand simple speech, are computers that, ultimately, are easier to use. Learning how you add these vital features to your applications will give your software a greater reach and appeal that can make a real difference to your target audience.

This book is arranged in the following parts:

Part I-Introduction covers some preliminary issues regarding the Windows Open Services Architecture (WOSA) upon which all three of the API sets are based.
Part II-The Messaging API (MAPI) contains chapters that describe the MAPI service model, review existing client and server software that implements the MAPI model, and show you how to use common developer tools for building MAPI-compliant applications. There are also several chapters devoted to creating commonly used MAPI-based programs, including e-mail clients, a broadcast mailing list manager, an e-mail-based discussion forum tool, and an e-mail agent. You'll also learn how to use the Microsoft Exchange Forms designer and discover how you can use C++ to create built-in extensions to the Windows Messaging client interface.
Part III-The Speech API (SAPI) covers the Microsoft Voice product available for Windows 95. You'll learn the details of the API model and how you can use it to create applications that use Text-to-Speech (TTS) and Speech Recognition (SR) engines to add a voice to your pc applications. You'll use both C++ and Visual Basic to build programs that respond to voice commands and read printed text back to users.
Part IV-The Telephony API (TAPI) outlines the API set that allows Windows programmers to add inbound and outbound telephony features to their applications. You'll learn about the telephony object model, and how to build simple dialing applications and basic inbound call handlers. Along the way you'll learn how to select telephony hardware and third-party TAPI development tools that will make it easier to build and maintain TAPI-compliant applications.
Part V-Creating Integrated Applications covers design issues you need to keep in mind when designing Windows applications that combine messaging, telephony, and speech services. You'll learn how to build a FaxBack service using MAPI and TAPI; an integrated voice response system that uses TAPI to allow users to call in and request data from the computer and have the results spoken over the phone; and an application that combines all three extension services to create an integrated voice and telephony application that uses voice commands to place outbound telephone calls.
Part VI-appendixes contains lists of third-party vendors for each of the three API sets and pointers to printed and online documentation sources, along with a handful of e-mail and Web addresses that you can use to keep current on these three technologies.

I encourage you to contact me via the Internet or through my Web site. I hope you enjoy this book, and I look forward to hearing from you soon.

Mike Amundsen
MikeAmundsen@msn.com www.iac.net/~mamund/