CHttpServerContext::GetServerVariable

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

Wartość zwracany

Niezerowa, jeśli kończy się pomyślnie, w przeciwnym razie 0. Jeśli wezwanie się nie powiedzie, funkcji systemu Windows GetLastError może być wywołana aby ustalić przyczynę błędu. 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 Zbyt mała, wymagany rozmiar powrócił w buforu * 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

Żąda ciągu zakończonych NULL wskazującą która zmiennej. Zobacz sekcję Spostrzeżenia listę bieżących zmiennych.

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 kopiuje informacje dotyczące połączenia HTTP lub serwera, do buforu dostarczonych przez obiekt wywołujący.

Możliwe wartości dla lpszVariableNames:

Wartość Znaczenie
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 pusty, brak uwierzytelniania jest używany.
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.
PATH_INFO Informacje dodatkowe ścieżki, podane przez klienta. To obejmuje końcowa część adresu URL po nazwa biblioteki DLL (skrypt) rozszerzenia, 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, którego odwołanie to rozszerzenie DLL.
REMOTE_ADDR Adres IP klienta.
ZMIENNA REMOTE_HOST Nazwa hosta klienta.
REMOTE_USER Zawiera &nazwy użytkownika dostarczonych przez klienta i poświadczone przez server.nbsp;
REQUEST_METHOD Metoda żądania HTTP.
SCRIPT_NAME Nazwa biblioteki DLL, który jest aktualnie wykonywany rozszerzenia.
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 program ISA lub serwer rozszerzenie DLL.
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.
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

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

Index