Funzione RasValidateEntryNameA (ras.h)

Articolo
11/20/2024

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 con rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file predefinito corrente della rubrica telefonica.

Windows Me/98/95: Questo parametro deve essere sempre NULL. La rete con accesso esterno 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 di simbolo
<	minore di simbolo
?	Punto interrogativo
*	asterisco
\	barra all'indietro
/	Barra
:	colon

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

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Codici di errore di routing e accesso remoto 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 della voce specificato non è valido.

Osservazioni

Il codice di esempio seguente convalida la voce della rubrica telefonica 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ras.h
libreria	Rasapi32.lib
dll	Rasapi32.dll

Vedere anche

RasCreatePhonebookEntry

RasGetEntryProperties

Panoramica servizio di accesso remoto (RAS)

funzioni del servizio accesso remoto

Condividi tramite