Metode IHttpContext::GetServerVariable

Mengambil variabel server tertentu.

Sintaks

virtual HRESULT GetServerVariable(  
   PCSTR pszVariableName,  
   PCWSTR * ppszValue,  
   DWORD * pcchValueLength  
) = 0;  
virtual HRESULT GetServerVariable(  
   PCSTR   pszVariableName,  
   PCSTR * ppszValue,  
   DWORD * pcchValueLength  
) = 0;  

Parameter

pszVariableName
Penunjuk ke string yang berisi nama variabel server yang akan dikembalikan.

ppszValue
Alamat penunjuk ke buffer string yang menerima salinan variabel server.

pcchValueLengthr
Penunjuk ke DWORD buffer yang menerima panjang ppszValue parameter.

Tampilkan Nilai

Sebuah HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Nilai	Deskripsi
S_OK	Menunjukkan bahwa operasi berhasil.
ERROR_INVALID_INDEX	Menunjukkan bahwa parameter tidak valid.

Keterangan

Metode mengambil GetServerVariable variabel server yang ditentukan oleh pszVariableName parameter dari konteks HTTP saat ini, dan mengembalikan nilai dalam buffer yang diacu oleh ppszValue parameter . Variabel server yang ditentukan oleh pszVariableName parameter dapat menjadi variabel kustom atau variabel yang ditentukan dalam Permintaan Komentar (RFC) 3875, "Antarmuka Gateway Umum (CGI) Versi 1.1."

Catatan

Metode ini GetServerVariable mendukung pengembalian nilai ANSI dan Unicode melalui metode yang kelebihan beban. Buffer yang ditujukkan oleh ppszValue parameter dapat berupa PCWSTR buffer atau PCSTR .

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 IHttpContext
Metode IHttpContext::SetServerVariable