fonction lineGetProviderList (tapi.h)

La fonction lineGetProviderList retourne une liste des fournisseurs de services actuellement installés dans le système de téléphonie.

Syntaxe

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

Paramètres

dwAPIVersion

Version la plus élevée de TAPI prise en charge par l’application (pas nécessairement la valeur négociée par lineNegotiateAPIVersion sur un périphérique de ligne particulier).

lpProviderList

Pointeur vers un emplacement de mémoire où TAPI peut retourner une structure LINEPROVIDERLIST . Avant d’appeler lineGetProviderList, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible à TAPI pour retourner des informations.

Note Si les paramètres de taille dans la structure ne sont pas corrects, il est possible que les données soient remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique allocation de mémoire .

 

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Configuration requise

Plateforme cible	Windows
En-tête	tapi.h
Bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

LINEPROVIDERLIST

Fonctions de service de ligne supplémentaires

Vue d’ensemble de la référence TAPI 2.2

lineNegotiateAPIVersion