CHttpServerContext::GetServerVariable

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 припинено рядок із зазначенням, яку змінну. Перегляньте зауваження розділі список поточних змінних.

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 Це містить ім'я користувача, надані клієнтом і засвiдченi в server. 
REQUEST_METHOD Запит HTTP методу.
SCRIPT_NAME Ім'я розширенням DLL, що бути виконана.
SERVER_NAME Сервера ім'я хоста (або IP адреси), як це має з'явитися у self-referencing URL-адреси.
SERVER_PORT TCP/IP порту, на якому було отримано запит.
SERVER_PROTOCOL Назва і версія протоколу пошуку інформації, що стосуються цього запиту. Зазвичай HTTP/1.0.
SERVER_SOFTWARE Назва і версія веб-сервера, під яким працює ISA або сервер розширенням DLL програми.
ALL_HTTP Всі заголовків HTTP, які не були вже обробити в один вище змінних. Ці змінні, мають HTTP_lt форму; заголовок поля ім'я & gt.
HTTP_ACCEPT Особливий випадок HTTP заголовка. Значення на прийняти: поля з'єднуються, розділених ",". Наприклад, якщо наступні рядки є частиною HTTP-заголовок
прийняти: * / *; q = 0.1
прийняти: тексту/html
прийняти: зображення/jpeg

потім HTTP_ACCEPT змінної буде мати значення:

*/*; q = 0.1, тексту/html, зображення/jpeg

Огляд CHttpServerContext |nbsp; Члени класу | Ієрархічна діаграма

Index