 |
Запись сообщений в канал Mailslot
|
|
|
|
Почтовые каналы передачи данных Mailslot
Способы организации передачи данных
Рассмотрим простой способ организации передачи данных между различными процессами, основанный на использовании дейтаграммных каналов Mailslot.
Каналы Mailslot позволяют выполнять одностороннюю передачу данных от одного или нескольких клиентов к одному или нескольким серверам.
Главная особенность каналов Mailslot заключается в том, что они, в отличие от других средств, рассмотренных нами, позволяют передавать данные в широковещательном режиме.
Это означает, что на компьютере или в сети могут работать несколько серверных процессов, способных получать сообщения через каналы Mailslot.
При этом один клиентский процесс может посылать сообщения сразу всем этим серверным процессам.
С помощью каналов Pipe вы не сможете передавать данные в широковещательном режиме, так как только два процесса могут создать канал типа Pipe.
MailSlot - это файл, находящийся в памяти, доступ к которому осуществляется стандартными файловыми функциями Win32. Данные в Mailslot могут быть в любой форме, но общий размер не может быть больше 64K.
Различают два типа процессов: MailSlot-сервер и MailSlot-клиент.
MailSlot-cервер - является процессом, который создает и обладает MailSlot. Когда сервер создает MailSlot, он получает хэндл.
Этот хэндл должен использоваться, когда процесс читает сообщения от MailSlot. Только процесс, который создает MailSlot или получает хэндл некоторым другим механизмом, может прочитать данные из MailSlot. Все MailSlot локальные на процессе, который создает их.
Процесс не может создать дистанционный MailSlot.
MailSlot-клиент - является процессом, который пишет сообщение в MailSlot. Любой процесс, который имеет имя MailSlot может записать в него информацию
|
|
|
Таким образом, MailSlot представляет собой простой и однонаправленный интерфейс взаимодействия между процессами. Процесс-сервер может завести почтовый ящик и дать ему имя, глобальное в сети. Любой клиент может с помощью операций работы с файлами отправить данные в этот ящик. Сервер, по мере необходимости, может читать переданные ему данные. Кроме этого, возможно широковещательная передача информации клиентом всем серверам домена.
Рассмотрим наиболее важные функции программного интерфейса Windows, предназначенные для работы с каналами MailSlot, которые сведем в таблицу 1.
Таблица 1
Функции для работы с каналами MailSlot
| № п/п | Функция | Назначение |
| CreateMailslot | Создание канала MailSlot | |
| CloseHandle | Закрытие хэндла канала | |
| GetMailslot | Определение текущего состояния канала Mailslot. | |
| SetMailslot | Изменение времени ожидания для канала Mailslot после его создания |
Создание канала Mailslot
Канал Mailslot создается серверным процессом с помощью специально предназначенной для этого функции CreateMailslot().
После создания серверный процесс получает хэндл канала Mailslot. Пользуясь этим хэндло, сервер может читать сообщения, посылаемые в канал клиентскими процессами.
Однако сервер не может выполнять над каналом Mailslot операцию записи, так как этот канал предназначен только для односторонней передачи данных - от клиента к серверу.
Синтаксис функции следующий
HANDLE CreateMailslot (LPCTSTR lpName, DWORD nMaxMsgSize, DWORD lReadTimeout, LPSECURITY_ATTRIBUTES lpSecurityAttributes)
Параметры:
lpName – указатель на строку имени канала Mailslot.
nMaxMsgSize – максимальный размер сообщения.
lReadTimeout – время ожидания для чтения.
lpSecurityAttributes – указатель на атрибуты защиты
Возвращаемое значение. При успешном выполнении – хэндл созданного канала Mailslot, при ошибке – INVALID_HANDLE_VALUEКод ошибки уточняется при вызове функции GetLastError()
Через первый параметр lpName передаются функции CreateMailslot()указатель на строку символов с именем канала Mailslot. Эта строка имеет следующий вид: \\.\mailslot\[Путь]ИмяКанала
|
|
|
В этом имени путь является необязательной компонентой. Тем не менее, вы можете указать его аналогично тому, как это делается для файлов. Что же касается имени канала Mailslot, то оно задается аналогично имени канала Pipes.
Второй параметр nMaxMsgSize определяет максимальный размер сообщений, передаваемых через создаваемый канал Mailslot.
Здесь можно указать нулевое значение, при этом размер сообщений не будет ограничен. Есть, однако, одно исключение - размер широковещательных сообщений, передаваемых всем рабочим станциям и серверам домена не должен превышать 400 байт.
С помощью третьего параметра lReadTimeout серверное приложение может задать время ожидания для операции чтения в миллисекундах, по истечении которого функция чтения вернет код ошибки.
Если указать в этом параметре значение MAILSLOT_WAIT_FOREVER, ожидание будет бесконечным.
Четвертый параметр lpSecurityAttributes задает адрес структуры защиты, который мы в наших приложениях будем указывать как NULL.
Пример 1
Представим использование функции CreateMailslot()в серверном приложении:
LPSTR lpszMailslotName = "\\\\.\\mailslot\\$MailslotName$";
hMailslot = CreateMailslot(lpszMailslotName, 0, MAILSLOT_WAIT_FOREVER, NULL);
В этом примере задан максимальный размер сообщения, поэтому на эту величину нет ограничений (кроме ограничения в 400 байт для сообщений, передаваемых всем компьютерам домена в широковещательном режиме).
Время ожидания указано как MAILSLOT_WAIT_FOREVER, поэтому функции, работающие с данным каналом Mailslot будут работать в блокирующем режиме.
Открытие канала Mailslot
Прежде чем приступить к работе с каналом Mailslot, клиентский процесс должен его открыть.
Для выполнения этой операции следует использовать функцию CreateFile(), например, так:
LPSTR lpszMailslotName = "\\\\.\\mailslot\\$MailslotName$";
hMailslot = CreateFile (lpszMailslotName, GENERIC_WRITE, FILE_SHARE_READ, NULL, OPEN_EXISTING, 0, NULL);
Здесь в качестве первого параметра функции CreateFile() передается имя канала Mailslot
Заметим, что возможно открыть канал Mailslot, созданный на другой рабочей станции в сети. Для этого строка имени канала, передаваемая функции CreateFile(), должна иметь следующий вид: \\ИмяРабочейСтанции\mailslot\[Путь]ИмяКанала
|
|
|
Можно открыть канал для передачи сообщений всем рабочим станциям заданного домена. Для этого необходимо задать имя по следующему образцу: \\ИмяДомена\mailslot\[Путь]ИмяКанала
Для передачи сообщений одновременно всем рабочим станциям сети первичного домена имя задается следующим образом: ь\\*\mailslot\[Путь]ИмяКанала
В качестве второго параметра функции CreateFile() передается константа GENERIC_WRITE
Эта константа определяет, что над открываемым каналом будет выполняться операция записи.
Напомним, что клиентский процесс может только посылать сообщения в канал Mailslotно не читать их оттуда. Чтение сообщений из канала Mailslot - задача для серверного процесса.
Третий параметр указан как FILE_SHARE_READ, и это тоже необходимо, так как сервер может читать сообщения, посылаемые одновременно несколькими клиентскими процессами.
Обратите также внимание на константу OPEN_EXISTING. Она используется потому, что функция CreateFile()открывает существующий канал, а не создает новый.
Запись сообщений в канал Mailslot
Запись сообщений в канал Mailslot выполняет клиентский процесс, вызывая для этого функцию WriteFile. С этой функцией мы уже имели дело. Например,
HANDLE hMailslot;
char szBuf[512];
DWORD cbWritten;
WriteFile (hMailslotszBuf, strlen(szBuf) + 1, &cbWritten, NULL);
В качестве первого параметра этой функции необходимо передать хэндл канала Mailslotполученный от функции CreateFile().
Второй параметр определяет адрес буфера с сообщением, третий - размер сообщения. В нашем случае сообщения передаются в виде текстовой строки, закрытой двоичным нулем, поэтому для определения длины сообщения была использована функция strlen.
|
|
|
