Fungsi RasValidateEntryNameA (ras.h)
Fungsi RasValidateEntryName memvalidasi format nama entri koneksi. Nama harus berisi setidaknya satu karakter alfanumerik spasi non-putih.
Sintaks
DWORD RasValidateEntryNameA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2
);
Parameter
[in] unnamedParam1
Penunjuk ke string yang dihentikan null yang menentukan jalur lengkap dan nama file file buku telepon (PBK). Jika parameter ini NULL, fungsi menggunakan file buku telepon default saat ini.
Windows Me/98/95: Parameter ini harus selalu NULL. Jaringan dial-up menyimpan entri buku telepon dalam registri, bukan dalam file buku telepon.
[in] unnamedParam2
Penunjuk ke string yang dihentikan null yang menentukan nama entri.
Karakter berikut ini tidak diperbolehkan dalam nama entri.
Karakter | Makna |
---|---|
|
bilah vertikal |
|
lebih besar dari simbol |
|
kurang dari simbol |
|
tanda tanya |
|
asterisk |
|
garis miring mundur |
|
garis miring |
|
Usus besar |
Windows 2000 atau yang lebih baru: Nama entri tidak dapat dimulai dengan titik (".").
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut atau nilai dari Kode Kesalahan Perutean dan Akses Jarak Jauh atau Winerror.h.
Nilai | Makna |
---|---|
|
Nama entri sudah ada dalam buku telepon yang ditentukan. |
|
Buku telepon yang ditentukan tidak ada. |
|
Format nama entri yang ditentukan tidak valid. |
Keterangan
Kode sampel berikut memvalidasi entri buku telepon yang ditentukan oleh variabel 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;
}
}
Catatan
Header ras.h mendefinisikan RasValidateEntryName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | ras.h |
Pustaka | Rasapi32.lib |
DLL | Rasapi32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk