Partager via


fonction lineGetTranslateCaps (tapi.h)

La fonction lineGetTranslateCaps retourne des fonctionnalités de traduction d’adresses.

Syntaxe

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

Paramètres

hLineApp

Handle retourné par la fonction lineInitializeEx . Si une application n’a pas encore appelé la fonction lineInitializeEx , ce paramètre peut être égal à zéro.

Note Les applications TAPI 1.4 doivent définir ce paramètre sur un handle hLineApp valide, tel que retourné par la fonction lineInitialize .
 

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).

lpTranslateCaps

Pointeur vers un emplacement vers lequel une structure LINETRANSLATECAPS est chargée. Avant d’appeler lineGetTranslateCaps, 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_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.

Configuration requise

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

Voir aussi

Informations de référence sur les services de téléphonie de base

LINETRANSLATECAPS

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

lineInitializeEx

lineNegotiateAPIVersion