SetMailslotInfo
Функция SetMailslotInfo устанавливает величину тайм-аута, используемую указанным мэйлслотом для операции чтения.
BOOL SetMailslotInfo (
HANDLE
hMailslot , //
дескриптор
мэйлслота
DWORD
lReadTimeout //
тайм - аут
чтения
);
Параметры
hMailslot
- идентифицирует мэйлслот. Этот дескриптор должна создать
функция CreateMailslot
.
lReadTimeout
- определяет количество времени, в миллисекундах, которое операция чтения может
ждать сообщения, записанного в мэйлслот, до наступления тайм-аута. Следующие величины
имеют специальные значения:
0 - функция
возвращает управление немедленно, если в мэйлслоте отсутствует сообщение. (Система
не трактует немедленное возвращение как ошибку.)
MAILSLOT_WAIT_FOREVER
- ждет до тех пор, пока не придет сообщение.
Величина тайм-аута применяется ко всем
последующим операциям чтения и всем унаследованным дескрипторам мэйлслота.
Возвращаемые значения
В случае успеха возвращается ненулевое
значение.
В случае неудачи возвращается
нуль. Для получения дополнительной информации об ошибке вызовите функцию
GetLastError
.
Комментарии
Начальное значение тайм-аута, используемое мэйлслотом для операции чтения, обычно устанавливается в функции CreateMailslot при создании мэйлслота.
См. также
CreateMailslot , GetMailslotInfo .