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-заголовказатем HTTP_ACCEPT переменная будет иметь значение: |
| 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; Члены класса | Иерархическая схема