fonction lineGetCountry (tapi.h)
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.
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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