RasGetCountryInfoA, fonction (ras.h)
La fonction RasGetCountryInfo récupère les informations de numérotation propres au pays/à la région à partir de la liste des pays/régions de téléphonie Windows.
Pour plus d’informations sur les informations de numérotation spécifiques au pays/à la région et sur les identificateurs de pays/région TAPI (Telephony Application Programming Interface), consultez la partie TAPI du Kit de développement logiciel (SDK) de plateforme.
Syntaxe
DWORD RasGetCountryInfoA(
[in, out] LPRASCTRYINFOA unnamedParam1,
[in, out] LPDWORD unnamedParam2
);
Paramètres
[in, out] unnamedParam1
Pointeur vers une structure RASCTRYINFO qui, lors de la sortie, reçoit les informations de numérotation spécifiques au pays/à la région, suivies d’octets supplémentaires pour une chaîne de description de pays/région.
Lors de l’entrée, définissez le membre dwSize de la structure sur sizeof(RASCTRYINFO) pour identifier la version de la structure. Définissez également le membre dwCountryId sur l’identificateur de pays/région TAPI du pays/de la région pour lequel obtenir des informations.
Allouez au moins 256 octets pour la mémoire tampon.
[in, out] unnamedParam2
Pointeur vers une variable qui, lors de l’entrée, spécifie la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre lpRasCtryInfo .
À la sortie, cette variable reçoit le nombre d’octets requis.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur provenant des codes d’erreur de routage et d’accès à distance ou winerror.h.
| Valeur | Signification |
|---|---|
|
L’adresse ou la mémoire tampon spécifiée par lpRasCtryInfo n’est pas valide. |
|
Le membre dwCountryId de la structure pointée par lpRasCtryInfo n’était pas une valeur valide. |
|
La taille de la mémoire tampon lpRasCtryInfo spécifiée par le paramètre lpdwSize n’était pas suffisamment grande pour stocker les informations du pays/de la région identifié par le membre dwCountryId . La fonction retourne la taille de mémoire tampon requise dans la variable pointée par lpdwSize. |
|
Les informations du sous-système TAPI ont été endommagées. |
Remarques
Pour énumérer les informations de tous les pays/régions de la liste téléphonie Windows, définissez le membre dwCountryId de la structure RASCTRYINFO sur 1 dans l’appel RasGetCountryInfo initial. La fonction retourne alors des informations pour le premier pays/région de la liste. La valeur retournée dans le membre dwNextCountryID est l’identificateur de pays/région du pays/région suivant dans la liste. Utilisez cette valeur dans les appels répétés à RasGetCountryInfo jusqu’à ce que dwNextCountryID retourne zéro, indiquant le dernier pays/région de la liste.
Notes
L’en-tête ras.h définit RasGetCountryInfo en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ras.h |
| Bibliothèque | Rasapi32.lib |
| DLL | Rasapi32.dll |