fonction lineGetTranslateCaps (tapi.h)

Article
08/26/2023

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.