RasValidateEntryNameA-Funktion (ras.h)

Artikel
08/25/2023

Die RasValidateEntryName-Funktion überprüft das Format eines Verbindungseintragsnamens. Der Name muss mindestens ein alphanumerisches Zeichen ohne Leerzeichen enthalten.

Syntax

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

Parameter

[in] unnamedParam1

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL ist, verwendet die Funktion die aktuelle Standardtelefonbuchdatei.

Windows Me/98/95: Dieser Parameter sollte immer NULL sein. Einwahlnetzwerk speichert Telefonbucheinträge in der Registrierung und nicht in einer Telefonbuchdatei.

[in] unnamedParam2

Zeiger auf eine NULL-endende Zeichenfolge, die einen Eintragsnamen angibt.

Die folgenden Zeichen sind in einem Eintragsnamen nicht zulässig.

Zeichen	Bedeutung
\|	Vertikaler Balken
>	Größer als Symbol
<	Kleiner als Symbol
?	Fragezeichen
*	Sternchen
\	Schrägstrich rückwärts
/	Schrägstrich
:	Doppelpunkt

Windows 2000 oder höher: Der Eintragsname darf nicht mit einem Punkt (".") beginnen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
ERROR_ALREADY_EXISTS	Der Eintragsname ist bereits im angegebenen Telefonbuch vorhanden.
ERROR_CANNOT_FIND_PHONEBOOK	Das angegebene Telefonbuch ist nicht vorhanden.
ERROR_INVALID_NAME	Das Format des angegebenen Eintragsnamens ist ungültig.

Hinweise

Der folgende Beispielcode überprüft den durch die Variable lpszEntry angegebenen Telefonbucheintrag.

#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;
    }
}

Hinweis

Der ras.h-Header definiert RasValidateEntryName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll

Weitere Informationen

RasCreatePhonebookEntry

RasGetEntryProperties

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts

Share via