RasValidateEntryNameW-Funktion (ras.h)

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

Syntax

DWORD RasValidateEntryNameW(
  [in] LPCWSTR unnamedParam1,
  [in] LPCWSTR unnamedParam2
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion die aktuelle Standarddatei des Telefonbuchs.

Windows Me/98/95: Dieser Parameter sollte immer NULL-sein. DFÜ-Netzwerke speichern Telefonbucheinträge in der Registrierung und nicht in einer Telefonbuchdatei.

[in] unnamedParam2

Zeiger auf eine mit Null beendete Zeichenfolge, die einen Eintragsnamen angibt.

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

Zeichen	Bedeutung
|	senkrechter Strich
>	größer als Symbol
<	Kleiner als Symbol
?	Fragezeichen
*	Sternchen
\	Schrägstrich nach hinten
/	Schrägstrich
:	Doppelpunkt

 

Windows 2000 oder höher: Der Eintragsname kann 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 Remotezugriffsfehlercodes oder Winerror.h.

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

Bemerkungen

Der folgende Beispielcode überprüft den durch die Variable lpszEntryangegebenen Phone-Book-Eintrag.

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

Anmerkung

Der ras.h-Header definiert RasValidateEntryName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ras.h
Library	Rasapi32.lib
DLL-	Rasapi32.dll

Siehe auch

RasCreatePhonebookEntry

RasGetEntryProperties

übersicht über Ras(Remote Access Service)

Remotezugriffsdienstfunktionen