Share via

lineShutdown

  • Article

This function shuts down the application's usage of the line abstraction of the API.

LONG lineShutdown(
HLINEAPP hLineApp);

Parameters

  • hLineApp
    [in] Application's usage handle for the line API.

Return Values

Zero indicates success. A negative error number indicates that an error occurred. Possible error values are as follows:

  • LINEERR_INVALAPPHANDLE
  • LINEERR_NOMEM
  • LINEERR_RESOURCEUNAVAIL
  • LINEERR_UNINITIALIZED

Remarks

If this function is called when the application has lines open or calls active, the call handles are deleted and TAPI automatically performs the equivalent of a lineClose on each open line. However, it is recommended that applications explicitly close all open lines before invoking lineShutdown. If shutdown is performed while asynchronous requests are outstanding, those requests are canceled.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Tapi.h   Coredll.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

lineClose

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.