PRADIUS_EXTENSION_PROCESS_EX fungsi panggilan balik (authif.h)

Artikel
08/22/2023

Catatan Layanan Autentikasi Internet (IAS) diganti namanya menjadi Network Policy Server (NPS) yang dimulai dengan Windows Server 2008. Konten topik ini berlaku untuk IAS dan NPS. Di seluruh teks, NPS digunakan untuk merujuk ke semua versi layanan, termasuk versi yang awalnya disebut sebagai IAS.

Fungsi RadiusExtensionProcessEx adalah fungsi yang ditentukan aplikasi dan dipanggil oleh NPS untuk setiap paket autentikasi atau akuntansi yang diterima NPS dari server akses jaringan (NAS). Fungsi ini mirip dengan RadiusExtensionProcess. Namun, RadiusExtensionProcessEx memungkinkan DLL Ekstensi untuk menambahkan atribut ke respons autentikasi.

Sintaks

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

DWORD PradiusExtensionProcessEx(
  [in]  const RADIUS_ATTRIBUTE *pInAttrs,
  [out] PRADIUS_ATTRIBUTE *pOutAttrs,
  [out] PRADIUS_ACTION pfAction
)
{...}

Parameter

[in] pInAttrs

Penunjuk ke array atribut dari permintaan. Array dihentikan oleh atribut dengan dwAttrType diatur ke ratMinimum. Atribut ini harus diperlakukan sebagai baca-saja; mereka tidak boleh dimodifikasi oleh RadiusExtensionProcessEx. Selain itu, atribut ini tidak boleh dirujuk dengan cara apa pun setelah RadiusExtensionProcessEx kembali.

[out] pOutAttrs

Penunjuk ke array atribut yang disediakan oleh DLL Ekstensi NPS. Array dihentikan oleh atribut dengan dwAttrType diatur ke ratMinimum. NPS menambahkan atribut ini ke respons autentikasi.

DLL Ekstensi NPS mengalokasikan memori untuk array atribut. NPS memanggil RadiusExtensionFreeAttributes untuk membebaskan memori yang ditempati oleh array atribut.

[out] pfAction

Penunjuk ke nilai jenis RADIUS_ACTION, awalnya diatur ke raContinue. Parameter ini menentukan tindakan yang harus diambil NPS sebagai respons terhadap Permintaan Akses.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai pengembalian harus menjadi kode kesalahan yang sesuai dari WinError.h.

Keterangan

Jika nilai yang dikembalikan adalah apa pun selain NO_ERROR, NPS akan membuang permintaan.

NPS mendukung beberapa DLL Ekstensi. NPS memanggil RadiusExtensionProcessEx untuk setiap DLL yang tercantum dalam registri. Untuk informasi selengkapnya lihat Menyiapkan DLL Ekstensi.

NPS memanggil RadiusExtensionFreeAttributes untuk membebaskan memori yang ditempati oleh array atribut yang dikembalikan oleh RadiusExtensionProcessEx. Untuk alasan ini, jika Anda menerapkan RadiusExtensionProcessEx, Anda juga harus menerapkan RadiusExtensionFreeAttributes.

Untuk informasi selengkapnya tentang penggunaan fungsi ini, lihat Proses Ekstensi NPS.