Metode IHttpUser::GetUserVariable

Mengembalikan data pengguna kustom berdasarkan nama.

Sintaks

virtual PVOID GetUserVariable(  
   IN PCSTR pszVariableName  
) = 0;  

Parameter

pszVariableName
[IN] Penunjuk ke string konstanta yang dihentikan null yang berisi nama variabel data yang akan diambil.

Tampilkan Nilai

void Penunjuk yang berisi data kustom yang diupcast.

Keterangan

Defaultnya adalah HTTP_USER_VARIABLE_SID, yang didefinisikan dalam file header Httpserv.h.

Catatan untuk Pelaksana

Pelaksana IHttpUser bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IHttpUser pelaksana yang menggunakan alokasi memori dinamis harus melepaskan atau deletevoid pointer 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 delete pointer yang dikembalikan void ketika data ini tidak lagi diperlukan. Selain itu, klien tidak boleh mengubah status memori yang direferensikan oleh pointer ini void , karena 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 yang mirip dengan yang berikut ini dengan aliran respons.

<?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