CHttpFilterContext::GetServerVariable

BOOL GetServerVariable (LPTSTR lpszVariableName, elementem LPVOID lpvBuffer, LPDWORD lpdwSize );

Wartość zwracany

Niezerowa, jeśli kończy się pomyślnie, w przeciwnym razie 0. Wywołania interfejsu Win32 API GetLastError może służyć do określenia, dlaczego nie powiodło się. Zawierają wartości możliwych błędów

Wartość	Znaczenie
ERROR_INVALID_PARAMETER	Dojścia połączenia zły.
ERROR_INVALID_INDEX	Zły lub nieobsługiwana zmienna identyfikator.
ERROR_INSUFFICIENT_BUFFER	Bufor zbyt mały; wymagany rozmiar jest zwracany w lpdwSize.
KOD ERROR_MORE_DATA	Zbyt mały bufor, zwracane tylko części danych. Całkowity rozmiar danych nie jest zwracane.
ERROR_NO_DATA	Wymagane dane nie jest dostępna.

Parametry

lpszVariableName

Ciąg zakończony zerem, wskazując, które zmienna jest wnioskuje. Zobacz sekcję Spostrzeżenia poniżej selekcji możliwych nazw. Wszystkie nazwy zmiennych są zdefiniowane w specyfikacji CGI, znajduje się na http://hoohoo.ncsa.uiuc.edu/cgi/env.html.

lpvBuffer

Wskaźnik do buforu do otrzymania żądanych informacji.

lpdwSize

Wskaźnik DWORD wskazująca liczbę bajtów dostępnych w buforze. Po pomyślnym zakończeniu DWORD zawiera liczbę bajtów przesłanych do bufora (łącznie z bajtem null kończące).

Uwagi

Ta funkcja Członkowskie nazywa się w ramach aby skopiować informacje dotyczące połączenia HTTP lub serwera, do buforu dostarczonych przez obiekt wywołujący. Obejmuje to możliwe lpszVariableNames:

Wartość	Znaczenie
ALL_HTTP	Wszystkie nagłówki HTTP, które nie były już analizowane na jeden z powyższych zmiennych. Zmienne są w postaci HTTP_lt; nazwa pola nagłówka & gt.
AUTH_TYPE	Zawiera typ uwierzytelniania used.nbsp; &Na przykład jeśli jest używane uwierzytelnianie podstawowe, ciąg będzie "Podstawowe". Dla systemu Windows NT wezwanie odpowiedź będzie on „NTLM". Inne schematy uwierzytelniania mają inne ciągi. Ponieważ nowe typy uwierzytelniania mogą być dodawane do serwera internetowego, nie jest możliwe sporządzenie wykazu wszystkich możliwych ciągów. Jeśli ciąg jest pusta, wówczas jest używane nie uwierzytelnianie.
CONTENT_LENGTH	Liczba bajtów, które skryptu można oczekiwać od klienta.
CONTENT_TYPE	Typ zawartości informacji dostarczonych w treści żądania POST.
GATEWAY_INTERFACE	Zmiana specyfikacji CGI, który spełnia ten serwer. Bieżąca wersja jest CGI/1.1.
SPECJALNY RODZAJ	Szczególny przypadek HTTP nagłówka. Wartości zaakceptować: pól są łączone, oddzielone ",". Na przykład, jeżeli następujące wiersze są częścią nagłówka HTTP `zaakceptować: * / ; q = 0,1 zaakceptować: text/html zaakceptować: image/jpeg` następnie zmienna specjalny rodzaj* będzie mieć wartość: `/; q = 0,1, text/html, image/jpeg`
PATH_INFO	Informacje dodatkowe ścieżki, podane przez klienta. To obejmuje końcowa część adresu URL po nazwie skryptu, ale przed ciąg kwerendy (jeśli występują).
PATH_TRANSLATED	To jest wartość PATH_INFO, ale z dowolną nazwę ścieżki wirtualnej rozwinięte w specyfikacji katalogu.
QUERY_STRING	Informacje, które następuje ? w adresie URL, co do których odwołuje się ten skrypt.
REMOTE_ADDR	Adres IP klienta.
ZMIENNA REMOTE_HOST	Nazwa hosta klienta.
REMOTE_USER	Zawiera nazwa_użytkownika dostarczonych przez klienta i uwierzytelniane przez serwer.
REQUEST_METHOD	Metoda żądania HTTP.
SCRIPT_NAME	Nazwa programu skrypt wykonywane.
NAZWA_SERWERA	Nazwa hosta serwera (lub adres IP), jak powinien pojawić się w samoodwołujących adresów URL.
SERVER_PORT	Port TCP/IP, na którym zostało odebrane żądanie.
SERVER_PROTOCOL	Nazwa i wersja protokołu pobierania informacji odnoszących się do tego żądania. Zwykle HTTP/1.0.
SERVER_SOFTWARE	Nazwa i wersja serwera sieci web, na którym uruchomiono CGI program.

Omówienie CHttpFilterContext |nbsp; Klasa członków | Wykres hierarchii

Index