lineAddProvider
This function installs a telephony service provider.
LONG lineAddProvider(
LPCWSTR lpszProviderFilename,
HWND hwndOwner,
LPDWORD lpdwPermanentProviderID
);
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
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.