Fungsi RasGetCustomAuthDataA (ras.h)

  • Artikel

Gunakan fungsi RasGetCustomAuthData untuk mengambil informasi autentikasi khusus koneksi. Informasi ini tidak spesifik untuk pengguna tertentu.

Sintaks

DWORD RasGetCustomAuthDataA(
  [in]      LPCSTR pszPhonebook,
  [in]      LPCSTR pszEntry,
  [out]     BYTE   *pbCustomAuthData,
  [in, out] DWORD  *pdwSizeofCustomAuthData
);

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.

[out] pbCustomAuthData

Penunjuk ke buffer yang menerima data autentikasi. Pemanggil harus mengalokasikan memori untuk buffer ini. Jika buffer tidak cukup besar, RasGetCustomAuthData mengembalikan ERROR_BUFFER_TOO_SMALL, dan parameter pdwSizeofEapData berisi ukuran yang diperlukan.

[in, out] pdwSizeofCustomAuthData

Penunjuk ke variabel DWORD yang, pada input, menentukan ukuran buffer yang ditunjukkan oleh parameter pbCustomAuthData .

Jika buffer yang ditentukan oleh parameter pbCustomAuthData 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 pdwSizeofCustomAuthData adalah NULL.
ERROR_BUFFER_TOO_SMALL
 Buffer yang ditunjukkan oleh pbCustomAuthData terlalu kecil untuk menerima data. pdwSizeofCustomAuthData 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 RasGetCustomAuthData 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

RasGetEapUserData

RasSetCustomAuthData