Partager via


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