Antarmuka IHttpUser

Menyediakan informasi khusus permintaan tentang pengguna. Informasi ini mencakup data seperti kredensial dan otorisasi berbasis peran.

Sintaks

class IHttpUser  

Metode

Tabel berikut mencantumkan metode yang diekspos oleh IHttpUser antarmuka.

Topik	Deskripsi
DereferenceUser	Mengurangi jumlah referensi internal pengguna.
GetAuthenticationType	Mengembalikan jenis autentikasi permintaan.
GetImpersonationToken	Mengembalikan token peniruan identitas pengguna.
GetPassword	Mengembalikan kata sandi pengguna.
GetPrimaryToken	Mengembalikan token pengguna utama.
GetRemoteUserName	Mengembalikan nama pengguna jarak jauh.
GetUserName	Mengembalikan nama pengguna.
GetUserVariable	Mengembalikan data pengguna kustom berdasarkan nama.
IsInRole	Mengembalikan nilai yang menunjukkan apakah pengguna diotorisasi untuk peran bernama.
ReferenceUser	Menaikkan jumlah referensi internal pengguna.
MendukungIsInRole	Mengembalikan nilai yang menunjukkan apakah dukungan peran diaktifkan untuk pengguna.

Kelas Turunan

Antarmuka ini tidak berisi kelas turunan.

Keterangan

Anda bisa mengambil penunjuk IHttpUser dari penunjuk IHttpContext dengan memanggil metode IHttpContext::GetUser . Untuk mendapatkan akses ke antarmuka ini, lihat Panduan: Membuat Modul HTTP Request-Level Dengan Menggunakan Kode Asli.

Contoh

Contoh kode berikut menunjukkan cara membuat modul HTTP yang menghapus header dan isi respons lalu mengembalikan informasi pengguna ke klien sebagai dokumen XML.

Kode di atas menulis XML yang mirip dengan yang berikut ini dengan aliran respons.

<?xml version="1.0" ?>  
<user   
    userName="DOMAIN\user"   
    remoteName=" DOMAIN\user"   
    passWord="[hidden]"   
    authType="Negotiate"   
    impersonationToken="valid"   
    primaryToken="valid"   
    supportsRoles="true"   
    isInRole="false"   
    userVariable="NULL" />  

Modul Anda harus mengekspor fungsi RegisterModule . Anda dapat mengekspor fungsi ini dengan membuat file definisi modul (.def) untuk proyek Anda, atau Anda dapat mengkompilasi modul dengan menggunakan sakelar /EXPORT:RegisterModule . Untuk informasi selengkapnya, lihat Panduan: Membuat Modul HTTP Request-Level Dengan Menggunakan Kode Asli.

Anda dapat secara opsional mengkompilasi kode dengan menggunakan __stdcall (/Gz) konvensi panggilan alih-alih secara eksplisit mendeklarasikan konvensi panggilan untuk setiap fungsi.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Lihat juga

Antarmuka Inti Server Web