fonction lineGetCountry (tapi.h)

Article
03/02/2024

La fonction lineGetCountry extrait les règles de numérotation stockées et d’autres informations relatives à un pays/région spécifié, au premier pays/région de la liste pays/région, ou à tous les pays/régions.

Syntaxe

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Paramètres

dwCountryID

Identificateur de pays/région (et non le code de pays) du pays/de la région pour lequel les informations doivent être obtenues. Si la valeur 1 est spécifiée, les informations sur le premier pays/région de la liste pays/région sont obtenues. Si la valeur 0 est spécifiée, des informations sur tous les pays/régions sont obtenues (ce qui peut nécessiter une grande quantité de mémoire ( 20 Ko ou plus).

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 appareil de ligne particulier).

lpLineCountryList

Pointeur vers un emplacement vers lequel une structure LINECOUNTRYLIST est chargée. Avant d’appeler lineGetCountry, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Note Si les paramètres de taille de 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 requête réussit ou un numéro 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_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER.