RasValidateEntryNameA-Funktion (ras.h)
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 |
---|---|
|
Der Eintragsname ist bereits im angegebenen Telefonbuch vorhanden. |
|
Das angegebene Telefonbuch ist nicht vorhanden. |
|
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 |