Русский справочник по Win32 API
Шрифт:
0 - функция возвращает управление немедленно, если в мэйлслоте отсутствует сообщение. (Система не трактует немедленное возвращение как ошибку.)
MAILSLOT_WAIT_FOREVER - ждет до тех пор, пока не придет сообщение.
Величина тайм-аута применяется ко всем последующим операциям чтения и всем унаследованным дескрипторам мэйлслота.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Начальное значение тайм-аута, используемое мэйлслотом для операции чтения, обычно устанавливается в функции CreateMailslot при создании мэйлслота.
См. также
CreateMailslot, GetMailslotInfo .
Справка
SetMenuContextHelpId
Функция SetMenuContextHelpId связывает идентификатор контекстной справки с меню. Все пункты меню разделяют этот идентификатор. Нет возможности назначить идентификатор контекстной справки индивидуальному пункту меню.
BOOL SetMenuContextHelpId (
HMENU hmenu ,
DWORD dwContextHelpId
);
Параметры
hmenu– дескриптор меню, с которым связывается идентификатор контекстной справки.
dwContextHelpId– идентификатор контекстной справки.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
См. также
GetMenuContextHelpId .
Таймеры
KillTimer
Функция 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
Функция QueryPerformanceCounter извлекает текущее значение счетчика производительности, если таковой существует.
BOOL QueryPerformanceCounter (
LARGE_INTEGER *lpPerformanceCount // адрес текущего значения счетчика
);
Параметры
lpPerformanceCount– указывает на переменную, которую функция устанавливает в текущее значение счетчика. Если установленное аппаратное обеспечение не поддерживает счетчик производительности, этот параметр может быть установлен в нуль.
Возвращаемые значения
В случае, если установленное аппаратное обеспечение поддерживает счетчик производительности, возвращается ненулевое значение.
Если установленное аппаратное обеспечение не поддерживает счетчик производительности, возвращается нуль.
См. также
QueryPerformanceFrequency .
QueryPerformanceFrequency
Функция QueryPerformanceFrequency извлекает частоту счетчика производительности, если таковой существует.
BOOL QueryPerformanceFrequency (
LARGE_INTEGER *lpFrequency // адрес текущей частоты
);
Параметры
lpFrequency– указывает на переменную, значение которой, в отсчетах в секунду, функция устанавливает в текущую частоту счетчика производительности. Если установленное аппаратное обеспечение не поддерживает счетчик производительности, значение этого параметра может быть равно нулю.
<