Функция GetServerVariable
Функция GetServerVariable возвращает значение "истина" при успешном выполнении и значение "ложь" при возникновении ошибки, как показано в следующем примере:
BOOL WINAPI GetServerVariable( HCONN hConn, LPSTR lpszVariableName, LPVOID lpvBuffer, LPDWORD lpdwSizeofBuffer );
Прототип GetServerVariable в данном случае требует передачи четырех параметров.
- hConn. Поддержка соединения, полученная от ECB.
- lpszVariableName. Строка с символом конца строки запрашиваемой серверной переменной.
- lpvBuffer. Пустой указатель на буфер, который заполняется результирующим значением имени переменной и байтом конца строки.
- lpdwSizeofBuffer. Указатель на значение DWORD, отражающее размер буфера.
При успешном выполнении функция GetServerVariable возвращает значение "истина". Указатель lpvBuffer указывает значение запрашиваемой серверной переменной, а lpdwSizeofBuffer – на новое значение DWORD, отражающее текущий размер значения, включая байт конца строки. При неудачном завершении работы функция GetServerValue возвращает значение "ложь". В этом случае вызывается функция GetLastError, которая возвращает значение DWORD, представляющее собой код ошибки. В таблице 5.2 показаны возможные ошибки функции GetServerVariable; это константы, определяемыми во вспомогательном файле заголовка расширения ISAPI.
