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 байт).
Зауваження
Цей член функція викликається за рамки для копіювання інформації щодо підключення до 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 заголовка. Значення на прийняти: поля з'єднуються, розділених ",". Наприклад, якщо наступні рядки є частиною 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 | Ім'я скрипта-програми, виконується. |
| SERVER_NAME | Сервера ім'я хоста (або IP адреси), як це має з'явитися у self-referencing URL-адреси. |
| SERVER_PORT | TCP/IP порту, на якому було отримано запит. |
| SERVER_PROTOCOL | Назва і версія протоколу пошуку інформації, що стосуються цього запиту. Зазвичай HTTP/1.0. |
| SERVER_SOFTWARE | Назва і версія веб-сервера, під яким працює програма CGI. |
Огляд CHttpFilterContext |nbsp; Члени класу | Ієрархічна діаграма