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