CHttpFilterContext::GetServerVariable

BOOL GetServerVariable (LPTSTR LpszVariableName, LPVOID LpvBuffer, LPDWORD LpdwSize );

Rückgabewert

Ungleich NULL, wenn erfolgreich, andernfalls 0. Der Win32 API-Aufruf GetLastError kann verwendet werden, um zu bestimmen, warum der Aufruf ist fehlgeschlagen. Mögliche Werte sind

Wert Bedeutung
ERROR_INVALID_PARAMETER Schlechte Verbindungs-handle.
ERROR_INVALID_INDEX Schlecht oder nicht unterstützte Variablenbezeichner.
ERROR_INSUFFICIENT_BUFFER Puffer zu klein; die erforderliche Größe wird in LpdwSize zurückgegeben.
ERROR_MORE_DATA Puffer zu klein, nur einen Teil der Daten zurückgegeben. Die Gesamtgröße der Daten wird nicht zurückgegeben.
ERROR_NO_DATA Die angeforderten Daten ist nicht verfügbar.

Parameter

lpszVariableName

NULL endende Zeichenfolge, die angibt, welche Variable angefordert wird. Finden Sie im Abschnitt Hinweise unten eine Auswahl der möglichen Namen. Alle Namen sind in der CGI-Spezifikation befindet sich am http://hoohoo.ncsa.uiuc.edu/cgi/env.html.

lpvBuffer

Zeiger auf den Puffer, der die angeforderte Informationen zu erhalten.

lpdwSize

Zeiger auf DWORD, die die Anzahl der Bytes im Puffer verfügbar. Nach erfolgreichem Abschluss enthält der DWORD-Wert die Anzahl der Bytes in den Puffer (einschließlich des Einstellung Null Bytes) übertragen.

Bemerkungen

Dieser Member-Funktion wird aufgerufen, durch das Framework um Informationen über eine HTTP-Verbindung, oder auf den Server selbst, in einen vom Aufrufer bereitgestellten Puffer zu kopieren. Mögliche LpszVariableNames sind:

Wert Bedeutung
ALL_HTTP Alle HTTP-Header, die nicht bereits in einer der oben genannten Variablen analysiert wurden. Diese Variablen sind von der Form HTTP_lt; Header-Feldnamen & gt.
AUTH_TYPE Enthält den Typ der Authentifizierung used.nbsp; Zum Beispiel, wenn Standardauthentifizierung verwendet wird, wird die Zeichenfolge "Basic" sein. Für Windows &NT Challenge-Response werden "NTLM". Anderen Authentifizierungsschemas werden andere Zeichenfolgen haben. Da neue Authentifizierungstypen Internet Server hinzugefügt werden können, ist es nicht möglich, alle mögliche Zeichenfolgen auflisten. Wenn die Zeichenfolge leer ist, wird keine Authentifizierung verwendet.
CONTENT_LENGTH Die Anzahl der Bytes, die das Skript vom Client empfangen erwarten können.
CONTENT_TYPE Der Inhaltstyp der Angaben im Körper von einer POST-Anforderung.
GATEWAY_INTERFACE Die Revision der CGI-Spezifikation, die dieser Server erfüllt. Die aktuelle Version ist CGI/1.1.
HTTP_ACCEPT Sonderfall HTTP-Header. Werte von der Accept: Felder verkettet werden, getrennt durch ",". Zum Beispiel, wenn die folgenden Zeilen sind Teil des HTTP-Headers
akzeptieren: * / *; q = 0,1
akzeptieren: text/html
akzeptieren: image/jpeg

dann wird die Variable HTTP_ACCEPT Wert haben:

*/*; Q = 0,1, Text/html, Image/Jpeg
PATH_INFO Zusätzliche Pfadinformationen, wie durch den Kunden gegeben. Dies umfasst den nachgestellten Teil der URL nach dem Skriptnamen, aber vor der Abfragezeichenfolge (sofern vorhanden).
PATH_TRANSLATED Dies ist der Wert von PATH_INFO, aber mit einem virtuellen Pfad-Namen in eine Verzeichnisangabe erweitert.
QUERY_STRING Die Informationen, die die ? in der URL folgt dieses Skript verwiesen.
REMOTE_ADDR Die IP-Adresse des Clients.
REMOTE_HOST Der Hostname des Clients.
REMOTE_USER Diese enthält den Benutzernamen, den vom Client und vom Server authentifiziert.
REQUEST_METHOD Die HTTP-Request-Methode.
SCRIPT_NAME Der Name des Programms Skript ausgeführt wird.
SERVER_NAME Der Servers-Hostname (oder IP-Adresse) als es sollte in Verweises auf sich selbst URLs angezeigt werden.
SERVER_PORT Der TCP/IP Port, auf dem die Anforderung empfangen wurde.
SERVER_PROTOCOL Der Name und die Version des Information-Retrieval-Protokolls für diese Anforderung. Normalerweise HTTP/1.0.
SERVER_SOFTWARE Name und Version des Web-Servers unter dem das CGI-Programm ausgeführt wird.

Übersicht über die CHttpFilterContext |nbsp; Member der Klasse | Hierarchiediagramm

Index