Fungsi RasGetEapUserDataA (ras.h)

  • Artikel

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
E_INVALIDARG
 Parameter pdwSizeofEapData adalah NULL.
ERROR_BUFFER_TOO_SMALL
 Buffer yang ditunjukkan oleh pbEapData terlalu kecil untuk menerima data. pdwSizeofEapData berisi ukuran yang diperlukan.
ERROR_CANNOT_OPEN_PHONEBOOK

RasGetEapUserData tidak dapat membuka file buku telepon yang ditentukan.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

RasGetEapUserData 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 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

RASEAPINFO

RasSetEapUserData

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh