Fonction RasValidateEntryNameA (ras.h)

La fonction RasValidateEntryName valide le format d’un nom d’entrée de connexion. Le nom doit contenir au moins un caractère alphanumérique non-espace blanc.

Syntaxe

DWORD RasValidateEntryNameA(
  [in] LPCSTR unnamedParam1,
  [in] LPCSTR unnamedParam2
);

Paramètres

[in] unnamedParam1

Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès complet et le nom de fichier d’un fichier d’annuaire téléphonique (PBK). Si ce paramètre a la valeur NULL, la fonction utilise le fichier d’annuaire téléphonique par défaut actuel.

Windows Me/98/95 : Ce paramètre doit toujours avoir la valeur NULL. La mise en réseau à distance stocke les entrées d’annuaire téléphonique dans le registre plutôt que dans un fichier d’annuaire téléphonique.

[in] unnamedParam2

Pointeur vers une chaîne terminée par null qui spécifie un nom d’entrée.

Les caractères suivants ne sont pas autorisés dans un nom d’entrée.

Caractère	Signification
|	barre verticale
>	supérieur au symbole
<	inférieur au symbole
?	point d'interrogation
*	astérisque
\	barre oblique arrière
/	Barre oblique
:	Colon

 

Windows 2000 ou version ultérieure : Le nom d’entrée ne peut pas commencer par un point (« . »).

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 de Winerror.h.

Valeur	Signification
ERROR_ALREADY_EXISTS	Le nom de l’entrée existe déjà dans le répertoire téléphonique spécifié.
ERROR_CANNOT_FIND_PHONEBOOK	L’annuaire téléphonique spécifié n’existe pas.
ERROR_INVALID_NAME	Le format du nom d’entrée spécifié n’est pas valide.

Notes

L’exemple de code suivant valide l’entrée de l’annuaire téléphonique spécifiée par la variable lpszEntry.

#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include <tchar.h>

DWORD __cdecl wmain(){

    LPTSTR lpszEntry = L"EntryName\0";

    DWORD nRet = RasValidateEntryName(NULL, lpszEntry);

    switch (nRet)
    {
        case ERROR_SUCCESS:
            printf("Entry name: %s is valid but doesn't exist in the default phone book\n", lpszEntry);
            break;
        case ERROR_INVALID_NAME:
            printf("Entry name: %s is invalid\n", lpszEntry);
            break;
        case ERROR_ALREADY_EXISTS:
            printf("Entry name: %s already exists in the default phone book\n", lpszEntry);
            break;
        default:
            printf("RasValidateEntryName failed: Error = %d\n", nRet);
            break;
    }
}

Notes

L’en-tête ras.h définit RasValidateEntryName comme un 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.

Spécifications

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

Voir aussi

RasCreatePhonebookEntry

RasGetEntryProperties

Vue d’ensemble du service d’accès à distance (RAS)

Fonctions du service d’accès à distance