struktur RADIUS_EXTENSION_CONTROL_BLOCK (authif.h)

Artikel
02/23/2024

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

Struktur RADIUS_EXTENSION_CONTROL_BLOCK menyediakan informasi tentang permintaan RADIUS saat ini. Ini juga menyediakan fungsi untuk mendapatkan atribut yang terkait dengan permintaan, dan untuk mengatur disposisi permintaan.

Sintaks

typedef struct _RADIUS_EXTENSION_CONTROL_BLOCK {
  DWORD                    cbSize;
  DWORD                    dwVersion;
  RADIUS_EXTENSION_POINT   repPoint;
  RADIUS_CODE              rcRequestType;
  RADIUS_CODE              rcResponseType;
  PRADIUS_ATTRIBUTE_ARRAY()(_RADIUS_EXTENSION_CONTROL_BLOCK *This) * GetRequest;
  PRADIUS_ATTRIBUTE_ARRAY()(_RADIUS_EXTENSION_CONTROL_BLOCK *This,RADIUS_CODE rcResponseType) * GetResponse;
  DWORD()(_RADIUS_EXTENSION_CONTROL_BLOCK *This,RADIUS_CODE rcResponseType)                   * SetResponseType;
} RADIUS_EXTENSION_CONTROL_BLOCK, *PRADIUS_EXTENSION_CONTROL_BLOCK;

Anggota

cbSize

Menentukan ukuran struktur.

dwVersion

Menentukan versi struktur.

repPoint

Menentukan nilai jenis RADIUS_EXTENSION_POINT yang menunjukkan pada titik mana dalam proses permintaan RadiusExtensionProcess2 dipanggil.

rcRequestType

Menentukan nilai jenis RADIUS_CODE yang menentukan jenis permintaan RADIUS yang diterima oleh server Layanan Autentikasi Internet.

rcResponseType

Menentukan nilai jenis RADIUS_CODE yang menunjukkan disposisi permintaan RADIUS.

GetRequest

Penunjuk ke fungsi GetRequest yang disediakan oleh NPS. NPS menetapkan nilai anggota ini.

Fungsi GetRequest mengembalikan atribut yang diterima dalam proses permintaan RADIUS dan atribut internal apa pun yang menjelaskan status permintaan.

DLL Ekstensi dapat mengubah atribut dalam permintaan RADIUS. Misalnya, jika NPS bertindak sebagai proksi RADIUS, DLL Ekstensi dapat memfilter atribut mana yang diteruskan ke server RADIUS jarak jauh.

Untuk memodifikasi atribut, DLL Ekstensi menggunakan fungsi yang disediakan sebagai anggota struktur RADIUS_ATTRIBUTE_ARRAY .

Ini

Penunjuk ke struktur RADIUS_EXTENSION_CONTROL_BLOCK . NPS meneruskan DLL Ekstensi penunjuk ke struktur ini saat memanggil struktur RadiusExtensionProcess2 .

GetResponse

Penunjuk ke fungsi GetResponse yang disediakan oleh NPS. NPS menetapkan nilai anggota ini.

Fungsi GetRequest mengembalikan atribut yang diterima dalam proses permintaan RADIUS dan atribut internal apa pun yang menjelaskan status permintaan.

DLL Ekstensi dapat menggunakan GetResponse untuk mengambil dan memodifikasi atribut untuk jenis respons yang valid terlepas dari disposisi permintaan saat ini. Misalnya, DLL Ekstensi dapat mengatur jenis respons ke rcAccessAccept, tetapi masih menambahkan atribut ke yang dikembalikan dalam kasus rcAccessReject. Respons yang ditentukan oleh DLL Ekstensi (rcAccessAccept dalam contoh ini) dapat ditimpa selama pemrosesan lebih lanjut.

Untuk memodifikasi atribut, DLL Ekstensi menggunakan fungsi yang disediakan sebagai anggota struktur RADIUS_ATTRIBUTE_ARRAY .

Ini

Penunjuk ke struktur RADIUS_EXTENSION_CONTROL_BLOCK . NPS meneruskan DLL Ekstensi penunjuk ke struktur ini saat memanggil fungsi RadiusExtensionProcess2 .

rcResponseType

Menentukan jenis respons. Parameter ini harus menjadi salah satu nilai yang dijumlahkan oleh jenis enumerasi RADIUS_CODE . Jika tidak, fungsi gagal, mengembalikan NULL.

SetResponseType

Penunjuk ke fungsi SetResponseType yang disediakan oleh NPS. NPS menetapkan nilai anggota ini.

Fungsi SetResponseType mengatur disposisi akhir permintaan.

Perhatikan bahwa disposisi yang ditetapkan oleh DLL Ekstensi dapat ditimpa selama pemrosesan lebih lanjut. Misalnya, DLL Ekstensi dapat mengatur jenis respons ke rcAccessAccept, tetapi selama pemrosesan lebih lanjut, respons dapat diubah ke rcAccessReject.

Ini

Penunjuk ke struktur RADIUS_EXTENSION_CONTROL_BLOCK . NPS meneruskan DLL Ekstensi penunjuk ke struktur ini saat memanggil fungsi RadiusExtensionProcess2 .

rcResponseType

Menentukan jenis respons. Parameter ini harus menjadi salah satu nilai yang terkandung dalam jenis enumerasi RADIUS_CODE dan terkait dengan anggota rcRequestType dari struktur RADIUS_EXTENSION_CONTROL_BLOCK . Jika rcRequestType sama dengan rcAccessRequest, nilai ini mungkin rcAccessAccept, rcAccessReject, rcAccessChallenge, atau rcDiscard. Jika rcRequestType sama dengan rcAccountingRequest, nilai ini dapat berupa rcAccountingResponse atau rcDiscard. Jika tidak, fungsi gagal, mengembalikan ERROR_INVALID_PARAMETER.

Keterangan

DLL Ekstensi tidak boleh mengubah struktur ini. Perubahan pada array atribut harus dilakukan dengan memanggil fungsi yang disediakan sebagai anggota struktur ini.

NPS meneruskan struktur ini ke DLL Ekstensi ketika memanggil implementasi Extension DLL dari RadiusExtensionProcess2.