Share via


lineAddProvider (Windows CE 5.0)

Send Feedback

This function installs a telephony service provider.

LONGlineAddProvider(LPCWSTRlpszProviderFilename,HWNDhwndOwner,LPDWORDlpdwPermanentProviderID);

Parameters

  • lpszProviderFilename
    Pointer to a null-terminated string that contains the path of the service provider DLL to be added.
  • hwndOwner
    Handle to a window in which any dialog boxes that need to be displayed as part of the installation process would be attached. Can be NULL to indicate that any window created during the function should have no owner window.
  • lpdwPermanentProviderID
    Pointer to a DWORD-sized memory location into which TAPI writes the permanent provider identifier of the newly installed service provider. This parameter can be NULL.

Return Values

Zero indicates success. A negative error number indicates that an error occurred. The following table shows the return values for this function.

Value Description
LINEERR_INIFILECORRUPT Corrupted INI file
LINEERR_NOMEM Not enough memory
LINEERR_INVALPARAM Invalid parameter
LINEERR_NOMULTIPLEINSTANCE Multiple instances not found
LINEERR_INVALPOINTER Invalid pointer
LINEERR_OPERATIONFAILED The operation failed

Remarks

In Windows CE, TAPI uses a function pointer table to call the service provider instead of using exported ordinal entry points. In lineAddProvider, TAPI calls the service provider's exported TSPI_lineGetProcTable function. This is the only function that a service provider must export. Then, TAPI calls the service provider's TSPI_providerInstall, TSPI_lineNegotiateTSPIVersion, TSPI_providerInit, and TSPI_providerEnumDevices.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.

See Also

lineInitialize | TSPI_lineNegotiateTSPIVersion | TSPI_providerInit | TSPI_providerInstall

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.