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
następnie zmienna specjalny rodzaj będzie mieć wartość:
|
Omówienie CHttpServerContext |nbsp; Klasa członków | Wykres hierarchii