Fungsi RasSetEapUserDataA (ras.h)

Gunakan fungsi RasSetEapUserData untuk menyimpan informasi Extensible Authentication Protocol (EAP) khusus pengguna untuk entri buku telepon yang ditentukan dalam registri.

Sintaks

DWORD RasSetEapUserDataA(
  [in] HANDLE hToken,
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbEapData,
  [in] DWORD  dwSizeofEapData
);

Parameter

[in] hToken

Tangani token akses utama atau peniruan identitas yang mewakili pengguna untuk menyimpan data. Parameter ini dapat berupa NULL jika fungsi dipanggil dari proses yang sudah berjalan dalam konteks pengguna.

[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] pbEapData

Arahkan ke data yang akan disimpan untuk pengguna.

[in] dwSizeofEapData

Menentukan ukuran data yang ditunjukkan oleh parameter pbEapData .

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 dwSizeofEapData adalah nol, atau parameter pbEapData 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 RasSetEapUserData 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

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

RasGetEapUserData

RasInvokeEapUI

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh