RegisterWindowMessage

UINT RegisterWindowMessage( LPCTSTR lpString );

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

В случае успешной регистрации сообщения, возвращает идентификатор сообщения в диапазоне от 0xC000 до 0xFFFF.

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

Аргументы

0. lpString — указатель на заканчивающуюся нулём строку, определяющую регистрируемое сообщение.

Примечание

Функция RegisterWindowMessage регистрирует новое сообщение окна и гарантирует его уникальность в системе. Возвращаемый идентификатор сообщения может использоваться при вызове функция SendMessage и PostMessage.

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

Если два различных приложения зарегистрировали одну и ту же строку сообщения, приложение возвращает один и тот же идентификатор сообщения. Сообщение остаётся зарегистрированным до перезагрузки операционной системы.

Использование функции RegisterWindowMessage является единственным способом обеспечить обработку одного и того же сообщения различными приложениями. Для посылки сообщений из одной функции класса окна в другую его функцию приложение может использовать любое целочисленное значение идентификатора сообщения в пределах от WM_USER до 0x7FFF. (Сообщения в данном диапазоне принадлежат классу окна, а не приложению). Этот диапазон значений используется, например, сообщениями классов таких элементов управления диалогового окна, как BUTTON, EDIT, LISTBOX и COMBOBOX.

Описание данной функции содержится в файле заголовка winuser.h. При работе с данной функцией следует включить в проект библиотеку user32.lib.

ResetEvent

BOOL ResetEvent( HANDLE hEvent );

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

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

Аргументы

0. hEvent — Дескриптор объекта события, возвращённый функцией CreateEvent или OpenEvent. В Windows NT этот аргумент должен иметь уровень доступа EVENT_MODIFY_STATE.

Примечание

Функция ResetEvent сбрасывает отмеченное состояние объекта события. Состояние объекта события после этого остаётся неотмеченным до следующего вызова функции SetEvent или PulseEvent. Это неотмеченное состояние блокирует выполнение любых потоков, указавших данный объект события в аргументе функций ожидания.

Данная функция используется преимущественно для ручного сброса состояния объектов. Объекты состояния, для которых определён автоматический сброс, сбрасываются после запуска первого же ожидающего потока.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.

SetCurrentDirectory

BOOL SetCurrentDirectory( LPCTSTR lpPathName );

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

Ненулевое, если сохранение прошло успешно. Если в процессе сохранения возникла ошибка, данная функция возвращает нулевое значение. Более подробную информацию об ошибке можно получить, вызвав функцию GetLastError.

Аргументы

0. lpPathName — указатель на заканчивающуюся нулём текстовую строку, содержащую путь в новый рабочий директорий. Этот параметр может быть как относительным, так и полным путём. В любом случае по данному аргументу определяется полный путь в директорий и запоминается как текущий директорий.

Примечание

Функция SetCurrentDirectory изменяет рабочий директорий для текущего процесса.

Каждый процесс имеет единственный рабочий директорий, имя которого состоит из двух частей:

• Имени диска, представляющего собой букву, соответствующую данному диску, за которой стоит символ двоеточия, или имя сервера и разделяемое имя (\\servername\sharename)

• Имени директория на этом диске.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.