Функция установки даты и времени

Дату и время в часах файл-сервера можно установить при помощи функции SetFileServerDateAndTime():

int SetFileServerDateAndTime(WORD Year, WORD Month, WORD Day, WORD Hour, WORD Minute, WORD Second);

Параметры этой функции задают новые значения для года (Year), месяца (Month), дня месяца (Day), часов (Hour), минут (Minute) и секунд (Second). Формат и назначение этих параметров аналогичны элементам массива, возвращаемого функцией GetFileServerDateAndTime().

В случае успешного завершения функция возвращает нулевое значение. Если эта функция вызвана пользователем, не имеющим прав оператора консоли, возвращается код ошибки C6h.

Вместо функции SetFileServerDateAndTime() можно использовать функцию E1h прерывания INT21h:

На входе:	AH	=	E1h;
	DS:SI	=	Адрес буфера запроса;
	ES:DI	=	Адрес буфера ответа.
На выходе:	AL	=	Код ошибки или 0, если операция завершилась без ошибок.

Буфер запроса:

struct REQUEST { WORD PacketLength; // размер пакета запроса BYTE Function; // должно быть равно 202 BYTE Year; // год BYTE Month; // месяц BYTE Day; // день BYTE Hour; // часы BYTE Minute; // минуты BYTE Second; // секунды };

Буфер ответа:

struct REPLAY { WORD PacketLength; // размер пакета };

Определение даты и времени

Функция GetFileServerDateAndTime() заполняет массив из 7 байт информацией об установке часов на файл-сервере:

void GetFileServerDateAndTime(BYTE *DateAndTime);

Параметр функции должен указывать на массив размером 7 байт. После вызова функции этот массив будет заполнен следующим образом:

Номер байта	Содержимое
0	Год (от 0 до 99). Значение 80 соответствует 1980 году, если значение меньше чем 80, то этот год относится к XXI веку
1	Месяц (от 1 до 12)
2	День месяца (от 1 до 31)
3	Час (от 0 до 23)
4	Минуты (от 0 до 59)
5	Секунды (от 0 до 59)
6	День недели (от 0 до 6: 0 - воскресенье, 1 - понедельник, 2 - вторник и т. д.)

Вместо функции GetFileServerDateAndTime() вы можете воспользоваться функцией E7h прерывания INT21h:

На входе:	AH	=	E7h;
	DS:DX	=	Адрес буфера размером 7 байт для записи информации о дате и времени, установленных на файл-сервере.
На выходе:			Регистры не используются.

Определение имени файл-сервера

Для определения имени файл-сервера по номеру канала, который рабочая станция использует для связи с ним, можно при помощи функции GetFileServerName():

void GetFileServerName(WORD ConnectionID, char *FileServerName);

Для файл-сервера, заданного параметром ConnectionID (номер канала), функция возвращает имя файл-сервера в массив FileServerName размером 48 байт.

Определение возможности подключения к файл-серверу

Программа, запущенная с рабочей станции пользователем с правами оператора консоли, может разрешать или запрещать подключение новых пользователей к файл-серверу. Для этого предназначены функции EnableFileServerLogin() и DisableFileServerLogin(), которые мы рассмотрим ниже. Для определения текущего состояния файл-сервера вы можете воспользоваться функцией GetFileServerLoginStatus():

int GetFileServerLoginStatus(int *LoginEnabledFlag);

По адресу, заданному параметром LoginEnabledFlag, функция запишет значение флага разрешения подключения. Если значение флага равно нулю, новые пользователи не могут подключаться к файл-серверу.

Останов файл-сервера

Иногда программе может потребоваться завершить работу файл-сервера. Это можно сделать при помощи функции DownFileServer():

int DownFileServer(int ForceFlag);

Параметр ForceFlag определяет, надо ли завершать работу файл-сервера, если есть рабочие станции, открывшие файлы в сетевых каталогах.

Если параметр установлен в нуль, при попытке завершить работу файл-сервера возвращается код ошибки FFh, если имеются открытые пользователями файлы.

Если значение параметра равно единице, сервер завершает свою работу в любом случае.

Вместо функции DownFileServer() можно использовать функцию E3h прерывания INT 21h:

На входе:	AH	=	E3h;
	DS:SI	=	Адрес буфера запроса;
	ES:DI	=	Адрес буфера ответа.
На выходе:	AL	=	Код ошибки или 0, если операция завершилась без ошибок.

Буфер запроса:

struct REQUEST { WORD PacketLength; // размер пакета запроса BYTE Function; // должно быть равно 211 BYTE ForceFlag; // FFh - завершить в любом случае // 00h - завершить, если нет открытых // файлов };

Буфер ответа:

struct REPLAY { WORD PacketLength; // размер пакета };

Получение строк описания файл-сервера

Получить в текстовом виде сведения о версии операционной системы Novell NetWare и о фирме-изготовителе можно с помощью функции GetFileServerDescriptionStrings():

int GetFileServerDescriptionStrings(char *CompanyName, char *Revision, char *RevisionDate, char *CopyrightNotice);

Параметр CompanyName должен указывать на буфер размером 80 байт, в который будет записано название фирмы-изготовителя NetWare (мы полагаем, что это всегда будет Novell).

Параметр Revision должен указывать на буфер размером 80 байт, в который будут записаны номер версии и номер изменений Novell NetWare.

Параметр RevisionDate - указатель на буфер размером 24 байта, в который будет записана дата внесения изменений.

Последний параметр, CopyrightNotice, должен указывать на буфер размером 80 байт, в который будут записаны сведения о правах на копирование операционной системы Novell NetWare.

Все строки будут закрыты двоичным нулем.

При успешном завершении функция возвращает нулевое значение.

УПРАВЛЕНИЕ ФАЙЛ-СЕРВЕРОМ

8.1.

8.2.

8.3.

8.4.

В последней главе нашей книги мы расскажем вам о некоторых функциях, предназначенных для получения справочной информации о состоянии файл-сервера и для управления файл-сервером.

Установка даты и времени

Иногда желательно синхронизировать часы на файл-сервере с часами рабочей станции. В этом вам поможет функция установки даты и времени в часах файл-сервера.

Запрет и разрешение подключений к серверу

Для того чтобы запретить подключение к файл-серверу новых пользователей программа должна вызывать функцию DisableFileServerLogin():

int DisableFileServerLogin(void);

Для того чтобы вновь разрешить пользователям подключаться к файл-серверу, следует вызвать функцию EnableFileServerLogin():

int EnableFileServerLogin(void);

Эту функцию может вызывать только пользователь, имеющий права оператора консоли.

Вместо функции DisableFileServerLogin() можно использовать функцию E3h прерывания INT 21h:

На входе:	AH	=	E3h;
	DS:SI	=	Адрес буфера запроса;
	ES:DI	=	Адрес буфера ответа.
На выходе:	AL	=	Код ошибки или 0, если операция завершилась без ошибок.

Буфер запроса:

struct REQUEST { WORD PacketLength; // размер пакета запроса BYTE Function; // должно быть равно 203 };

Буфер ответа:

struct REPLAY { WORD PacketLength; // размер пакета };

Вместо функции EnableFileServerLogin() также можно использовать функцию E3h прерывания INT 21h, подготовив буфер запроса и ответа следующим образом:

Буфер запроса:

struct REQUEST { WORD PacketLength; // размер пакета запроса BYTE Function; // должно быть равно 204 };

Буфер ответа:

struct REPLAY { WORD PacketLength; // размер пакета };