CHttpFilterContext::GetServerVariable

BOOL GetServerVariable (LPTSTR lpszVariableName、LPVOID lpvBuffer、LPDWORD lpdwSize );

戻り値

成功した場合は 0 以外それ以外の場合 0。Win32 API 呼び出し GetLastErrorを使用して、呼び出しが失敗した理由を判断することができます。エラー値が含まれます

意味
ERROR_INVALID_PARAMETER 不正な接続ハンドル。
悪いまたはサポートされていない変数識別子。
ERROR_INSUFFICIENT_BUFFER バッファが小さすぎます。lpdwSizeに必要なサイズが返される。
ERROR_MORE_DATA バッファが小さすぎて、データの一部のみを返します。データの合計サイズは返されません。
ERROR_NO_DATA 要求されたデータは利用できません。

パラメーター

lpszVariableName

変数を示す null で終わる文字列を要求されています。名前の選択は、以下の備考部分を参照してください。Http://hoohoo.ncsa.uiuc.edu/cgi/env.htmlである CGI の仕様で定義されているすべての変数名であります。

lpvBuffer

要求された情報を受け取るバッファーへのポインター。

lpdwSize

バッファーの使用可能なバイト数を示す DWORD へのポインター。正常に完了には (null 終端のバイトを含む)、バッファーに転送されたバイト数には dword 値が含まれています。

解説

このメンバー関数は、情報関連する HTTP 接続、または、サーバー自体は、呼び出し元によって指定されたバッファーにコピーするため、フレームワークによって呼び出されます。可能なlpszVariableNamesを含める:

意味
ALL_HTTP 既に上記の変数の 1 つに解析されていないすべての HTTP ヘッダー。これらの変数は、フォーム HTTP_lt、ヘッダー フィールド名 & gt は。
AUTH_TYPE 認証 used.nbsp の種類が含まれています。たとえば、基本認証を使用する場合、文字列"Basic"になります。Windows NT チャレンジ/レスポンスは、"NTLM"になります。他の認証スキームは、他の文字列になります。新しい認証の種類はインターネット サーバーに追加することができますので、すべての可能な文字列を一覧表示することはできません。文字列が空の場合、認証は使用されません。(&N)。
CONTENT_LENGTH クライアントから受信するには、スクリプトが期待できるバイト数。
CONTENT_TYPE POST 要求の本体に指定されている情報のコンテンツの種類。
GATEWAY_INTERFACE このサーバーに準拠する CGI 仕様のリビジョン。CGI や 1.1 は、現在のバージョンです。
HTTP_ACCEPT 特別な場合 HTTP ヘッダー。Accept の値: フィールドが連結で区切られた「」。たとえば、HTTP ヘッダーの一部を次に示します
受け入れる: ※/※;q = 0.1受け入れる: テキストと html受け入れる: イメージ ・ jpeg

[ HTTP_ACCEPT変数の値をが:

*/*;q = 0.1、テキスト、html、イメージ/jpeg
PATH_INFO クライアントによって指定された追加のパス情報。これは、URL の末尾の部分がクエリ文字列の前に、スクリプト名の後 (もしあれば) 構成します。
PATH_TRANSLATED これはPATH_INFOの値が、仮想パス名と、ディレクトリ仕様に拡大。
QUERY_STRING 、このスクリプト参照 URL で次のように、情報。
REMOTE_ADDR クライアントの IP アドレス。
REMOTE_HOST クライアントのホスト名。
REMOTE_USER これは、クライアントによって提供され、サーバーで認証にユーザー名が含まれています。
REQUEST_METHOD HTTP 要求メソッド。
SCRIPT_NAME 実行中のスクリプト プログラムの名前。
SERVER_NAME サーバーのホスト名 (または IP アドレス) は自己参照 Url に表示する必要があります。
SERVER_PORT 要求を受信した、TCP/IP ポート。
SERVER_PROTOCOL 名前とこの要求に関連する情報検索プロトコルのバージョン。通常の HTTP/1.0。
SERVER_SOFTWARE CGI プログラムが実行されている web サーバーのバージョンと名前。

CHttpFilterContext 概要|nbsp;クラス メンバー |階層図(&N)

Index