Fungsi RasSetCustomAuthDataA (ras.h)

  • Artikel

Gunakan fungsi RasSetCustomAuthData untuk mengatur informasi autentikasi khusus koneksi. Informasi ini tidak boleh spesifik untuk pengguna tertentu.

Sintaks

DWORD RasSetCustomAuthDataA(
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbCustomAuthData,
  [in] DWORD  dwSizeofCustomAuthData
);

Parameter

[in] pszPhonebook

Penunjuk ke string yang dihentikan null yang menentukan jalur lengkap file buku telepon (PBK). Jika parameter ini NULL, fungsi menggunakan buku telepon sistem.

[in] pszEntry

Penunjuk ke string yang dihentikan null yang menentukan nama entri yang ada.

[in] pbCustomAuthData

Penunjuk ke buffer yang menentukan data autentikasi baru.

[in] dwSizeofCustomAuthData

Menentukan ukuran data yang diacu oleh parameter pbCustomAuthData .

Mengembalikan nilai

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
E_INVALIDARG
 Parameter dwSizeofCustomAuthData adalah nol, atau parameter pbCustomAuthData adalah NULL.
ERROR_CANNOT_OPEN_PHONEBOOK

RasSetEapUserData tidak dapat membuka file buku telepon yang ditentukan.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

RasSetEapUserData tidak dapat menemukan entri yang ditentukan dalam buku telepon.
Lainnya
 Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Keterangan

Catatan

Header ras.h mendefinisikan RasSetCustomAuthData sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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

Persyaratan Nilai
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

RasGetCustomAuthData

RasSetEapUserData