Функция 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.