nf-tapi-linegetproviderlist.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:tapi.lineGetProviderList	lineGetProviderList function (tapi.h)	The lineGetProviderList function (tapi.h) returns a list of service providers currently installed in the telephony system.	_tapi2_linegetproviderlist lineGetProviderList lineGetProviderList function [TAPI 2.2] lineGetProviderListA lineGetProviderListW tapi/lineGetProviderList tapi/lineGetProviderListA tapi/lineGetProviderListW tapi2.linegetproviderlist	tapi2\linegetproviderlist.htm	tapi3	87d43409-e8c5-401a-87a2-02568ed0af4a	08/09/2022	_tapi2_linegetproviderlist, lineGetProviderList, lineGetProviderList function [TAPI 2.2], lineGetProviderListA, lineGetProviderListW, tapi/lineGetProviderList, tapi/lineGetProviderListA, tapi/lineGetProviderListW, tapi2.linegetproviderlist	tapi.h		Windows						lineGetProviderListW (Unicode) and lineGetProviderListA (ANSI)						Tapi32.lib	Tapi32.dll		Windows			19H1	lineGetProviderList tapi/lineGetProviderList	c++	APIRef kbSyntax	DllExport	Tapi32.dll	lineGetProviderList lineGetProviderListA lineGetProviderListW

lineGetProviderList function

-description

The lineGetProviderList function returns a list of service providers currently installed in the telephony system.

-parameters

-param dwAPIVersion

Highest version of TAPI supported by the application (not necessarily the value negotiated by lineNegotiateAPIVersion on some particular line device).

-param lpProviderList

Pointer to a memory location where TAPI can return a LINEPROVIDERLIST structure. Prior to calling lineGetProviderList, the application must set the dwTotalSize member of this structure to indicate the amount of memory available to TAPI for returning information.

Note  If the size parameters in the structure are not correct, there is a possibility that data could get overwritten. For more information on setting structure sizes, see the memory allocation topic.

 

-returns

Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.

-see-also

LINEPROVIDERLIST

Supplementary Line Service Functions

TAPI 2.2 Reference Overview

lineNegotiateAPIVersion