Funzione RasValidateEntryNameA (ras.h)

Articolo
08/25/2023

La funzione RasValidateEntryName convalida il formato di una voce di connessione. Il nome deve contenere almeno un carattere alfanumerico senza spazi vuoti.

Sintassi

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

Parametri

[in] unnamedParam1

Puntatore a una stringa con terminazione Null che specifica il percorso completo e il nome file di un file della rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file di rubrica predefinito corrente.

Windows Me/98/95: Questo parametro deve essere sempre NULL. La rete di connessione remota archivia le voci della rubrica nel Registro di sistema anziché in un file di rubrica telefonica.

[in] unnamedParam2

Puntatore a una stringa con terminazione Null che specifica un nome di voce.

I caratteri seguenti non sono consentiti in un nome di voce.

Carattere	Significato
\|	barra verticale
>	maggiore del simbolo
<	minore di simbolo
?	punto interrogativo
*	asterisco
\	barra indietro
/	Barra
:	Colon

Windows 2000 o versione successiva: Il nome della voce non può iniziare con un punto (".").

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Routing e Remote Access Error Codes o Winerror.h.

Valore	Significato
ERROR_ALREADY_EXISTS	Il nome della voce esiste già nella rubrica specificata.
ERROR_CANNOT_FIND_PHONEBOOK	La rubrica specificata non esiste.
ERROR_INVALID_NAME	Il formato del nome di voce specificato non è valido.

Commenti

Il codice di esempio seguente convalida la voce della rubrica specificata dalla variabile 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;
    }
}

Nota

L'intestazione ras.h definisce RasValidateEntryName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ras.h
Libreria	Rasapi32.lib
DLL	Rasapi32.dll

Vedi anche

RasCreatePhonebookEntry

RasGetEntryProperties

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto

Condividi tramite