Тарас Сорока - Русский справочник по Win32 API

См. также

CreateMailslot, SetMailslotInfo.

Функция SetMailslotInfoустанавливает величину тайм-аута, используемую указанным мэйлслотом для операции чтения.

BOOL SetMailslotInfo(

HANDLE hMailslot , // дескриптор мэйлслота

DWORD lReadTimeout // тайм - аут чтения

);

Параметры

hMailslot - идентифицирует мэйлслот. Этот дескриптор должна создать функция CreateMailslot.

lReadTimeout - определяет количество времени, в миллисекундах, которое операция чтения может ждать сообщения, записанного в мэйлслот, до наступления тайм-аута. Следующие величины имеют специальные значения:

0 - функция возвращает управление немедленно, если в мэйлслоте отсутствует сообщение. (Система не трактует немедленное возвращение как ошибку.)

MAILSLOT_WAIT_FOREVER - ждет до тех пор, пока не придет сообщение.

Величина тайм-аута применяется ко всем последующим операциям чтения и всем унаследованным дескрипторам мэйлслота.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError.

Комментарии

Начальное значение тайм-аута, используемое мэйлслотом для операции чтения, обычно устанавливается в функции CreateMailslotпри создании мэйлслота.

См. также

CreateMailslot, GetMailslotInfo.

Функция SetMenuContextHelpIdсвязывает идентификатор контекстной справки с меню. Все пункты меню разделяют этот идентификатор. Нет возможности назначить идентификатор контекстной справки индивидуальному пункту меню.

BOOL SetMenuContextHelpId(

HMENU hmenu ,

DWORD dwContextHelpId

);

Параметры

hmenu - дескриптор меню, с которым связывается идентификатор контекстной справки.

dwContextHelpId - идентификатор контекстной справки.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

См. также

GetMenuContextHelpId.

Функция KillTimerразрушает указанный таймер.

BOOL KillTimer(

HWND hWnd , // дескриптор окна, установившего таймер

UINT uIDEvent // идентификатор таймера

);

Параметры

hWnd - идентифицирует окно, связанное с указанным таймером. Значение должно совпадать со значением параметра hWnd , переданным функции SetTimer, создавшей таймер.

uIDEvent - указывает таймер, который должен быть разрушен. Если дескриптор окна, переданный в функцию SetTimer, не равен NULL, то значение uIDEvent при вызове KillTimerдолжно совпадать со значением uIDEvent , переданного в SetTimer. Если приложение вызывало SetTimerс hWnd , установленным в NULL, то значение этого параметра должно быть идентификатором таймера, возвращенным SetTimer.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError.

Комментарии

Функция KillTimerне удаляет сообщения WM_TIMER, уже помещенные в очередь сообщений.

См. также

SetTimer, WM_TIMER.

Функция QueryPerformanceCounterизвлекает текущее значение счетчика производительности, если таковой существует.

BOOL QueryPerformanceCounter(

LARGE_INTEGER *lpPerformanceCount // адрес текущего значения счетчика

);

Параметры

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

Возвращаемые значения

В случае, если установленное аппаратное обеспечение поддерживает счетчик производительности, возвращается ненулевое значение.

Если установленное аппаратное обеспечение не поддерживает счетчик производительности, возвращается нуль.

См. также

QueryPerformanceFrequency.

Функция QueryPerformanceFrequencyизвлекает частоту счетчика производительности, если таковой существует.

BOOL QueryPerformanceFrequency(

LARGE_INTEGER *lpFrequency // адрес текущей частоты