Table of Contents Index NMS Glossary Previous Page Next Page (Page 15 of 15 in this chapter) Version


faxStopSession

Description

Stops a current send or receive operation.

Prototype

DWORD faxStopSession ( HFAX hFax)

hFax Handle returned by TAPI.

Return Values

Events

Details

After the application invokes faxStopSession, NaturalFax for TAPI immediately terminates the current send or receive operation. Cancellation is complete when the FAXMSG_SESSION_DONE event arrives.

This function should be used when the application encounters an unexpected error. The fax session terminates abruptly, and is not completed with a T.30 DCN message. This function should also be used when the telephone call is terminated by the remote end and the application is not using the ADI service or ISDN Natural Call Control Interface (Layer 4) functions for call control. For example, when low layer ISDN protocols are used by the application, NaturalFax for TAPI is not notified when the call is released. Therefore, the application must use faxStopSession to terminate an active fax session.

See Also

faxAnswerFaxPoll, faxReceiveFax, faxSendFax



Table of Contents Index NMS Glossary Previous Page Next Page (Page 15 of 15 in this chapter) Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, Natural MicroSystems, Inc. All rights reserved.