Fungsi RasGetEapUserDataA (ras.h)
Gunakan fungsi RasGetEapUserData untuk mengambil informasi Extensible Authentication Protocol (EAP) khusus pengguna untuk entri buku telepon yang ditentukan.
Sintaks
DWORD RasGetEapUserDataA(
[in] HANDLE hToken,
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[out] BYTE *pbEapData,
[in, out] DWORD *pdwSizeofEapData
);
Parameter
[in] hToken
Tangani token akses utama atau peniruan identitas yang mewakili pengguna untuk mengambil 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.
[out] pbEapData
Penunjuk ke buffer yang menerima data EAP yang diambil untuk pengguna. Pemanggil harus mengalokasikan memori untuk buffer ini. Jika buffer tidak cukup besar, RasGetEapUserData mengembalikan ERROR_BUFFER_TOO_SMALL, dan parameter pdwSizeofEapData berisi ukuran yang diperlukan.
[in, out] pdwSizeofEapData
Penunjuk ke variabel DWORD yang, pada input, menentukan ukuran buffer yang ditunjukkan oleh parameter pbEapData .
Jika buffer yang ditentukan oleh parameter pbEapData tidak cukup besar, pdwSizeofEapData menerima, pada output, ukuran yang diperlukan.
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 |
---|---|
|
Parameter pdwSizeofEapData adalah NULL. |
|
Buffer yang ditunjukkan oleh pbEapData terlalu kecil untuk menerima data. pdwSizeofEapData berisi ukuran yang diperlukan. |
|
RasGetEapUserData tidak dapat membuka file buku telepon yang ditentukan. |
|
RasGetEapUserData tidak dapat menemukan entri yang ditentukan dalam buku telepon. |
|
Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan. |
Keterangan
Catatan
Header ras.h mendefinisikan RasGetEapUserData sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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
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