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 ヘッダーの一部を次に示します[ HTTP_ACCEPT変数の値をが: |
| 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)