Metode IHttpUser::GetUserName

Mengembalikan nama pengguna.

Sintaks

virtual PCWSTR GetUserName(  
   VOID  
) = 0;  

Parameter

Metode ini tidak memerlukan parameter.

Tampilkan Nilai

Penunjuk ke string Unicode yang dihentikan null konstanta yang berisi nama pengguna.

Keterangan

Nilai yang dikembalikan tergantung pada jenis autentikasi. Jenis autentikasi dikembalikan dari metode GetAuthenticationType .

Tabel berikut ini memperlihatkan jenis autentikasi dengan nilai atau pola nama pengguna terkait.

Jenis autentikasi	Nama pengguna
Anonim	String kosong
Dasar	Domain\Username
digest	domain\nama pengguna atau nama pengguna
Form	Nama pengguna
Windows	Domain\Username

Catatan untuk Pelaksana

IHttpUser pelaksana bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IHttpUser pelaksana yang menggunakan alokasi memori dinamis harus melepaskan atau memanggil delete penunjuk PCWSTR ketika tidak lagi diperlukan.

Catatan untuk Penelepon

IHttpUser pelaksana bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IHttpUser klien tidak boleh merilis atau memanggil delete penunjuk yang PCWSTR dikembalikan ketika data ini tidak lagi diperlukan. Selain itu, klien tidak boleh mentransmisikan data ini ke penunjuk yang bukan const atau mengubah status memori yang direferensikan oleh ini PCWSTR; jika tidak, pelanggaran akses akan dilemparkan atau data akan menjadi tidak valid.

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 ke aliran respons yang mirip dengan yang berikut ini.

<?xml version="1.0" ?>  
<user userName="DOMAIN\user" />  

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 IHttpUser
Metode IHttpUser::GetPassword
Metode IHttpUser::GetRemoteUserName