CHttpFilterContext::GetServerVariable

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

Возвращаемое значение

Ненулевое значение, если успешно, в противном случае 0. Вызов Win32 API GetLastError может использоваться для определения причины сбоя вызова. Возможные ошибки значения:

Значение Значение
ERROR_INVALID_PARAMETER Плохое соединение ручки.
ERROR_INVALID_INDEX Плохие или неподдерживаемый идентификатор переменной.
ERROR_INSUFFICIENT_BUFFER Буфер слишком мал; требуемый размер возвращается в lpdwSize.
ERROR_MORE_DATA Буфер слишком мал, возвращается только часть данных. Общий размер данных не возвращается.
ERROR_NO_DATA Запрашиваемых данных не доступен.

Параметры

lpszVariableName

Завершающим нулем строка, указывающая, какие переменной требуется. В разделе примечания ниже для отбора возможных имен. Все имена переменных, как определено в спецификации CGI, расположенный в http://hoohoo.ncsa.uiuc.edu/cgi/env.html.

lpvBuffer

Указатель на буфер для получения запрашиваемой информации.

lpdwSize

Указатель типа DWORD, указывающее количество байтов в буфере. При успешном завершении DWORD содержит количество байтов, переданных в буфер (включая прекращение null байт).

Примечания

Эта функция-член вызывается framework для копирования информации, касающейся HTTP-соединение, или на самом сервере, в буфер от вызывающего. Включают возможные lpszVariableNames:

Значение Значение
ALL_HTTP Все заголовки HTTP, которые уже не разобрать в одну из выше переменных. Эти переменные имеют форму HTTP_lt; имя поля заголовка & gt.
AUTH_TYPE Содержит тип аутентификации used.nbsp; Например если используется обычная проверка подлинности, строка будет «Basic». Для Windows &NT вызов ответ он будет «NTLM». Другие схемы аутентификации будет иметь другие строки. Поскольку Интернет-сервер могут быть добавлены новые типы аутентификации, невозможно перечислить все возможные строки. Если строка пуста, то проверка подлинности не используется.
CONTENT_LENGTH Количество байт, которые сценарий можно ожидать от клиента.
CONTENT_TYPE Тип содержимого информацию, представленную в теле запроса POST.
GATEWAY_INTERFACE Версия спецификации CGI, которому соответствует этот сервер. Текущая версия — CGI/1.1.
HTTP_ACCEPT Особый случай HTTP заголовок. Значения Accept: поля объединяются, разделенных «,». Например, если следующие строки являются частью HTTP-заголовка
примите: * / *; q = 0.1
примите: текст/html
примите: image/jpeg

затем HTTP_ACCEPT переменная будет иметь значение:

*/*; q = 0.1, текст/html, image/jpeg
PATH_INFO Дополнительные сведения о пути, как клиент. В их число входят завершающая часть URL-адреса после имени сценария, но до строки запроса (если имеется).
PATH_TRANSLATED Это значение PATH_INFO, но с любым именем виртуального пути расширена в спецификацию каталогов.
QUERY_STRING Информация, которая следует ? в URL-АДРЕСЕ, на который ссылается этот сценарий.
REMOTE_ADDR IP-адрес клиента.
REMOTE_HOST Имя узла клиента.
REMOTE_USER Содержит имя пользователя от клиента и проверку подлинности на сервере.
REQUEST_METHOD Метод HTTP запроса.
SCRIPT_NAME Имя сценария программы осуществляются.
ИМЯ_СЕРВЕРА Имя хоста сервера (или IP-адрес), как он должен появиться в выполняемому URL-адресов.
SERVER_PORT Порт TCP/IP, на который был получен запрос.
SERVER_PROTOCOL Имя и версия протокола поиска информации, связанных с этой просьбой. Обычно HTTP/1.0.
SERVER_SOFTWARE Имя и версия веб-сервере, под которой выполняется программа CGI.

Обзор CHttpFilterContext |nbsp; Члены класса | Иерархическая схема

Index