BOOL GetServerVariable (LPTSTR lpszVariableName, LPVOID lpvBuffer, LPDWORD lpdwSize );
Возвращаемое значение
Ненулевое значение, если успешно, в противном случае 0. Если не удается, функции Windows GetLastError может быть вызвана для определения причины ошибки. Возможные ошибки значения:
Значение | Значение |
ERROR_INVALID_PARAMETER | Плохое соединение ручки. |
ERROR_INVALID_INDEX | Плохие или неподдерживаемый идентификатор переменной. |
ERROR_INSUFFICIENT_BUFFER | Буфер слишком мал, необходимого размера, вернулся в * lpdwSize. |
ERROR_MORE_DATA | Буфер слишком мал, возвращается только часть данных. Общий размер данных не возвращается. |
ERROR_NO_DATA | Запрашиваемых данных не доступен. |
Параметры
lpszVariableName
Значение NULL типа прекращенных string переменной которой запрашивается. В разделе Примечания для списка текущих переменных.
lpvBuffer
Указатель на буфер для получения запрашиваемой информации.
lpdwSize
Указатель типа DWORD , указывающее количество байтов в буфере. При успешном завершении DWORD содержит количество байтов, переданных в буфер (включая прекращение null байт).
Примечания
Эта функция копирует информацию о HTTP-соединение, или на самом сервере, в буфер от вызывающей.
Возможные значения для lpszVariableNames :
Значение | Значение |
AUTH_TYPE | Содержит тип аутентификации used.nbsp; Например если используется обычная проверка подлинности, строка будет «Basic». Для Windows &NT вызов ответ он будет «NTLM». Другие схемы аутентификации будет иметь другие строки. Поскольку Интернет-сервер могут быть добавлены новые типы аутентификации, невозможно перечислить все возможные строки. Если строка пуста, то проверка подлинности не используется. |
CONTENT_LENGTH | Количество байт, которые сценарий можно ожидать от клиента. |
CONTENT_TYPE | Тип содержимого информацию, представленную в теле запроса POST. |
GATEWAY_INTERFACE | Версия спецификации CGI, которому соответствует этот сервер. Текущая версия — CGI/1.1. |
PATH_INFO | Дополнительные сведения о пути, как клиент. В их число входят завершающая часть URL-адреса после расширения имени DLL (скрипт), но до строки запроса (если имеется). |
PATH_TRANSLATED | Это значение PATH_INFO, но с любым именем виртуального пути расширена в спецификацию каталогов. |
QUERY_STRING | Информация, которая следует? в URL-АДРЕСЕ которой ссылки на этот DLL расширения. |
REMOTE_ADDR | IP-адрес клиента. |
REMOTE_HOST | Имя узла клиента. |
REMOTE_USER | Содержит имя пользователя от клиента и заверен server. |
REQUEST_METHOD | Метод HTTP запроса. |
SCRIPT_NAME | Имя расширения DLL выполняется. |
ИМЯ_СЕРВЕРА | Имя хоста сервера (или IP-адрес), как он должен появиться в выполняемому URL-адресов. |
SERVER_PORT | Порт TCP/IP, на который был получен запрос. |
SERVER_PROTOCOL | Имя и версия протокола поиска информации, связанных с этой просьбой. Обычно HTTP/1.0. |
SERVER_SOFTWARE | Имя и версия веб-сервере, под которой запущена программа DLL расширения ISA или сервера. |
ALL_HTTP | Все заголовки HTTP, которые уже не разобрать в одну из выше переменных. Эти переменные имеют форму HTTP_lt; имя поля заголовка & gt. |
HTTP_ACCEPT | Особый случай HTTP заголовок. Значения Accept: поля объединяются, разделенных «,». Например, если следующие строки являются частью HTTP-заголовка
затем HTTP_ACCEPT переменная будет иметь значение:
|
Обзор CHttpServerContext |nbsp; Члены класса | Иерархическая схема