Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.winnt.rsm.org.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.winnt.rsm.org.ru/winapi/winapi.htm
Раздел "C++Builder": http://www.winnt.rsm.org.ru/cbuilder/cbuilder.htm
Раздел "Советы & примеры": http://www.winnt.rsm.org.ru/tipstricks/tipstricks.htm
Обновления на сайте
В раздел "C++Builder" добавились материалы к книге К. Рейсдорфа
"Освой самостоятельно Borland C++Builder".
В раздел WInAPI добавились функции по работе с мэйлслотами.
Перевод
Сегодня вашему вниманию представлен перевод функции SetMailslotInfo.
SetMailslotInfo
Функция SetMailslotInfo устанавливает величину тайм-аута, используемую указанным
мэйлслотом для операции чтения.
BOOL SetMailslotInfo(
HANDLE hMailslot, // дескриптор мэйлслота
DWORD lReadTimeout // тайм-аут чтения
);
Параметры
hMailslot – идентифицирует мэйлслот. Этот дескриптор должна создать функция CreateMailslot.
lReadTimeout – определяет количество времени, в миллисекундах, которое операция
чтения может ждать сообщения, записанного в мэйлслот, до наступления тайм-аута.
Следующие величины имеют специальные значения:
0 – функция возвращает управление немедленно, если в мэйлслоте отсутствует сообщение.
(Система не трактует немедленное возвращение как ошибку.)
MAILSLOT_WAIT_FOREVER – ждет до тех пор, пока не придет сообщение.
Величина тайм-аута применяется ко всем последующим операциям чтения и всем унаследованным
дескрипторам мэйлслота.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об
ошибке вызовите функцию GetLastError.
Комментарии
Начальное значение тайм-аута, используемое мэйлслотом для операции чтения, обычно
устанавливается в функции CreateMailslot при создании мэйлслота.
См. также
CreateMailslot, GetMailslotInfo.
хелп по WinAPI: http://www.winnt.rsm.org.ru/winapi/winapirefresh.htm
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru