lineGetProviderList
The lineGetProviderList
function returns a list of service providers currently installed in the
telephony system.
LONG lineGetProviderList(
|
DWORD dwAPIVersion, |
|
|
LPLINEPROVIDERLIST lpProviderList |
|
|
); |
|
Parameters
dwAPIVersion
The highest
version of TAPI supported by the application (not necessarily the value
negotiated by lineNegotiateAPIVersion on some particular line device).
lpProviderList
A pointer to
a memory location where TAPI will return a LINEPROVIDERLIST structure. Prior
to calling lineGetProviderList, the application should set the dwTotalSize
field of this structure to indicate the amount of memory available to TAPI for
returning information.
Return Values
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
LINEERR_INCOMPATIBLEAPIVERSION,
LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED,
LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.
Remarks
Although this
is a new function which older applications would not be expected to call, for
backward compatibility, they should not be prevented from doing so. The
function will work the same way for all applications.
See Also