RasGetEntryPropertiesA, fonction (ras.h)
La fonction RasGetEntryProperties récupère les propriétés d’une entrée par téléphone.
Syntaxe
DWORD RasGetEntryPropertiesA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in, out] LPRASENTRYA unnamedParam3,
[in, out] LPDWORD unnamedParam4,
[out] LPBYTE unnamedParam5,
[in, out] LPDWORD unnamedParam6
);
Paramètres
[in] unnamedParam1
Pointeur vers une chaîne null-terminated qui spécifie le chemin d’accès complet et le nom de fichier d’un fichier PBK (Phone-Book). Si ce paramètre est NULL, la fonction utilise le fichier de livre téléphonique par défaut actuel. Le fichier de carnet téléphonique par défaut est celui sélectionné par l’utilisateur dans la feuille de propriétés Préférences utilisateur de la boîte de dialogue Mise en réseau rendez-vous.
Windows Me/98/95 : Ce paramètre doit toujours être NULL. La mise en réseau rendez-vous stocke les entrées de livres téléphoniques dans le Registre plutôt que dans un fichier de livres téléphoniques.
[in] unnamedParam2
Pointeur vers une chaîne null-terminated qui spécifie un nom d’entrée existant. Si une chaîne vide est spécifiée, la fonction retourne les valeurs par défaut dans les mémoires tampons pointées par les paramètres lpRasEntry et lpbDeviceInfo.
[in, out] unnamedParam3
Pointeur vers une structure RASENTRY suivie d’octets supplémentaires pour la liste de numéros de téléphone de remplacement, s’il en existe un.
En sortie, la structure reçoit les données de connexion associées à l’entrée de carnet téléphonique spécifiée par le paramètre lpszEntry.
Lors de l’entrée, définissez le membre dwSize de la structure sur sizeof(RASENTRY) pour identifier la version de la structure.
Ce paramètre peut être NULL.
Windows Me/98 et Windows 95 OSR2 : La couche Microsoft pour Unicode ne prend pas en charge dwAlternateOffset dans RASENTRY .
[in, out] unnamedParam4
Pointeur vers une variable qui, en entrée, spécifie la taille, en octets, de la mémoire tampon lpRasEntry.
En sortie, cette variable reçoit le nombre d’octets requis.
Ce paramètre peut être
Pour déterminer la taille de mémoire tampon requise, appelez RasGetEntryProperties avec lpRasEntry défini sur NULL et *lpdwEntryInfoSize défini sur zéro. La fonction retourne la taille de mémoire tampon requise dans *lpdwEntryInfoSize.
[out] unnamedParam5
Ce paramètre n’est plus utilisé. La fonction appelante doit définir ce paramètre sur NULL .
Windows Me/98/95 : pointeur vers une mémoire tampon qui reçoit des informations de configuration spécifiques à l’appareil. Ne manipulez pas directement ces informations d’appareil TAPI opaques. Pour plus d’informations sur la configuration des appareils TAPI, consultez la fonction lineGetDevConfig dans la référence du programmeur TAPI dans le Kit de développement logiciel (SDK) de plateforme.
Ce paramètre peut être NULL.
[in, out] unnamedParam6
Ce paramètre n’est pas utilisé. La fonction appelante doit définir ce paramètre sur NULL .
Windows Me/98/95 : Pointeur vers une variable qui, en entrée, spécifie la taille, en octets, de la mémoire tampon spécifiée par le paramètre lpbDeviceInfo.
En sortie, cette variable reçoit le nombre d’octets requis.
Ce paramètre peut être NULL si le paramètre lpbDeviceInfo s NULL.
Pour déterminer la taille de mémoire tampon requise, appelez RasGetEntryProperties avec lpbDeviceInfo défini sur NULL et *lpdwDeviceInfoSize défini sur zéro. La fonction retourne la taille de mémoire tampon requise dans *lpdwDeviceInfoSize.
Valeur de retour
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 de Codes d’erreur d’acheminement et d’accès à distance ou Winerror.h.
| Valeur | Signification |
|---|---|
|
La fonction a été appelée avec un paramètre non valide. |
|
La valeur du membre dwSize du lpRasEntry est trop petite. |
|
L’adresse ou la mémoire tampon spécifiée par lpRasEntry n’est pas valide. |
|
La taille de la mémoire tampon indiquée dans lpdwEntryInfoSize est trop petite. |
|
L’entrée par téléphone n’existe pas, ou le fichier de livres téléphoniques est endommagé et/ou a des composants manquants. |
Remarques
Note
L’en-tête ras.h définit RasGetEntryProperties comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | ras.h |
| bibliothèque | Rasapi32.lib |
| DLL | Rasapi32.dll |
Voir aussi
Vue d’ensemble service d’accès à distance (RAS)