Поиск по сайту:


Смотри также:

Пошаговая инструкция по работе с программой P-CAD (ACCEL EDA) - Статья.

Новая таблица умножения - Статья.

MSDN по русски. Описание классов и функций Visual C++ .NET - Статья.

Стандарты MPEG - Статья.

Все новинки...

Статья «MSDN по русски. Глобальные функции Windows C++ .NET»

Поделиться:

1    2    3

_CrtCheckMemory

int _CrtCheckMemory(void);

Возвращаемое значение
В случае успешного завершения проверки возвращает значение TRUE. В противном случае возвращает значение FALSE.
Описание
Данная функция производит проверку целостности блока памяти в куче отладки (действует только в отладочной версии приложения). При обнаружении ошибок в целостности кучи отладки или в ее заголовке, а также записи информации за пределами выделенных буферов, функция _CrtCheckMemory выдает отладочное сообщение с указанием выявленной ошибки. Если символ _DEBUG не определен, вызов данной функции удаляется препроцессором. Поведением функции _CrtCheckMemory можно управлять, устанавливая различные поля во флаге _crtDbgFlag с использование функции _CrtSetDbgFlag. Установка флага _CRTDBG_CHECK_ALWAYS_DF приводит к тому, что функция _CrtCheckMemory вызывается при каждом запросе на выделение памяти. Хотя это и замедляет выполнение приложения, зато ускоряет процесс выявления ошибок. Сброс флага _CRTDBG_ALLOC_MEM_DF отменяет проверку кучи и заставляет функцию _CrtCheckMemory всегда возвращать значение TRUE. Поскольку данная функция возвращает логическое значение, ее вызов может быть помещен в макрос _ASSERT, что позволит быстро локализовать возникшие ошибки. Описание данной функции содержится в файле заголовка crtdbg.h.
_CrtDumpMemoryLeaks

int _CrtDumpMemoryLeaks(void);

Возвращаемое значение
В случае обнаружения утечек памяти возвращает значение TRUE. В противном случае возвращает значение FALSE.
Описание
Данная функция производит распечатку информации по всем блокам памяти при обнаружении утечек памяти (действует только в отладочной версии приложения). Функция _CrtDumpMemoryLeaks проверяет, не возникло ли утечек памяти с момента запуска приложения. При обнаружении утечек памяти производится распечатка содержимого заголовков всех объектов, расположенных в куче, в удобочитаемой форме. Если символ _DEBUG не определен, вызов данной функции удаляется препроцессором. Данная функция, как правило, вызывается в конце работы приложения для проверки того, что вся выделенная в нем память освобождена. Для автоматического запуска этой функции в конце работы приложения достаточно с использованием функции _CrtSetDbgFlag установить поле _CRTDBG_LEAK_CHECK_DF во флаге _crtDbgFlag. Для получения информации о текущем состоянии кучи отладки функция _CrtDumpMemoryLeaks вызывает функцию _CrtMemCheckpoint. После этого она производит поиск не освобожденных блоков памяти. При обнаружении такого блока она вызывает функцию _CMemDumpAllObjectsSince, выводящую информацию обо всех блоках памяти, выделенных с момента запуска приложения на исполнение. По умолчанию блоки _CRT_BLOCK не включаются в эту распечатку. Для их включения в распечатку достаточно с использованием функции _CrtSetDbgFlag установить поле _CRTDBG_CHECK_CRT_DF во флаге _crtDbgFlag. Описание данной функции содержится в файле заголовка crtdbg.h.
_CrtSetDbgFlag

int _CrtSetDbgFlag(int newFlag);

Возвращаемое значение
Возвращает предыдущее состояние флага _crtDbgFlag.
Аргументы

 newFlag - новое значение флага _crtDbgFlag. В данном флаге могут быть установлены следующие поля:
      _CRTDBG_ALLOC_MEM_DF - разрешает добавление в кучу отладки нового блока и использование для него идентификаторов типа таких, как _CLIENT_BLOCK. Если он сброшен, добавляет блок в список кучи, но устанавливает для него тип _IGNORE_BLOCK. По умолчанию этот флаг установлен. Совместим с любыми макросами, задающими режим проверки кучи отладки;
      _CRTDBG_CHECK_ALWAYS_DF - устанавливает режим вызова функции _CrtCheckMemory при каждом запросе на выделение и освобождение памяти в куче. Если он сброшен, функцию _CrtCheckMemory нужно вызывать в явном виде. По умолчанию этот флаг сброшен. При установке данного флага любые макросы, задающие режим проверки кучи отладки, игнорируются;
      _CRTDBG_CHECK_CRT_DF - включает блоки типа _CRT_BLOCK в распечатку при обнаружении утечек памяти и несоответствия состояния памяти. Если он сброшен, внутренняя память библиотек времени исполнения приложения не распечатывается. По умолчанию этот флаг сброшен. Совместим с любыми макросами, задающими режим проверки кучи отладки;
      _CRTDBG_DELAY_FREE_MEM_DF - сохраняет освобожденные блоки памяти в связном списке кучи, назначая им тип _FREE_BLOCK и заполняя их байты значениями 0xDD. Если он сброшен, освобожденные блоки памяти не хранятся в связном списке кучи. По умолчанию этот флаг сброшен. Совместим с любыми макросами, задающими режим проверки кучи отладки;
      _CRTDBG_LEAK_CHECK_DF - производит автоматическую проверку на отсутствие утечек памяти при завершении работы приложения, используя для этого вызов функции _CrtDumpMemoryLeaks. Если он сброшен, автоматическая проверка не осуществляется. По умолчанию этот флаг сброшен. Совместим с любыми макросами, задающими режим проверки кучи отладки;
      _CRTDBG_REPORT_FLAG - сохраняет предыдущее значение флага. Используется при модификации флага для сохранения его текущего состояния во временной переменной.

Описание
Данная функция позволяет установить или изменить состояние флага _crtDbgFlag, управляющего режимом работы функций слежения за кучей отладки. (Действует только в отладочной версии приложения). Если символ _DEBUG не определен, вызов данной функции удаляется препроцессором. Макросы, задающие режим проверки кучи отладки, определяют число вызовов функций malloc, realloc, free и _msize за которыми последует вызов функции _CrtCheckMemory. Определены следующие макросы, задающие режим проверки кучи отладки:

      _CRTDBG_CHECK_EVERY_16_DF - проверка производится после 16 вызовов;
      _CRTDBG_CHECK_EVERY_128_DF - проверка производится после 128 вызовов;
      _CRTDBG_CHECK_EVERY_1024_DF - проверка производится после 1024 вызовов;
      _CRTDBG_CHECK_DEFAULT_DF - эквивалентен макросу _CRTDBG_CHECK_EVERY_1024_DF. Для задания этих макросов используются 16 старших разрядов аргумента newFlag.

Описание данной функции содержится в файле заголовка crtdbg.h.
AddFontResource

int AddFontResource(LPCTSTR lpszFilename);

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

lpszFilename - указатель на заканчивающуюся нулем текстовую строку, содержащую корректное имя файла шрифта. Имя файла шрифта имеет расширение .fon для файлов ресурса шрифта, расширение .fnt для файлов шрифта, содержащих битовые образы символов, расширение ttf для файлов шрифтов TrueType и расширение .fot для файлов ресурсов шрифтов TrueType.

Описание
Функция AddFontResource позволяет добавить ресурсы шрифта из указанного файла в системную таблицу шрифтов. После этого данный шрифт может быть использован для вывода текста любым приложением Win32. Любые приложения, добавляющие или удаляющие шрифты из системной таблицы шрифтов, извещают об этом другие приложения посылкой сообщения WM_FONTCHANGE всем окнам верхнего уровня в операционной системе. Для посылки этого сообщения приложение должно использовать функцию SendMessage, в аргументе hWnd которой должно стоять значение HWND_BROADCAST. Как только приложение перестает использовать ресурс шрифта, загруженный функцией AddFontResource, оно должно удалить его функциейRemoveFontResource.
AfxBeginThread

CWinThread* AfxBeginThread(AFX_THREADPROC pfnThreadProc, LPVOID pParam, int nPriority = THREAD_PRIORITY_NORMAL, UINT nStackSize = 0, DWORD dwCreateFlags = 0, LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL); CWinThread* AfxBeginThread(CRuntimeClass* pThreadClass, int nPriority = THREAD_PRIORITY_NORMAL, UINT nStackSize = 0, DWORD dwCreateFlags = 0, LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL);

Возвращаемое значение
Указатель на созданный данной функцией объект класса потока.
Аргументы

pfnThreadProc - указатель на исполняющую функцию рабочего потока. Не может иметь нулевого значения. Исполняющая функция потока имеет следующий формат:
UINT MyControllingFunction(LPVOID pParam); pThreadClass - указатель на структуру CRuntimeClass для пользовательского класса, производного от класса CWinThread.
pParam - аргумент, передаваемый исполняющей функции потока, как показано в описании аргумента pfnThreadProc.
nPriority - приоритет потока. Если эта величина равна нулю, то у создаваемого потока устанавливается такой же приоритет, как и у вызывающего потока. Полный список значений приоритетов приведен в описании функции SetThreadPriority.
nStackSize - определяет размер стека нового потока в байтах. Если эта величина равна нулю, то у создаваемого потока создается стек того же размера, что и у вызывающего потока.
dwCreateFlags - определяет дополнительный флаг, управляющий процессом создания потока. Этот флаг может иметь два значения:
CREATE_SUSPENDED - создает поток, в котором счетчик остановки установлен в единицу. Этот поток не будет исполняться, пока не будет вызвана функция ResumeThread;
0 - начать работу потока непосредственно после его создания.
lpSecurityAttrs - указатель на объект структуры SECURITY_ATTRIBUTES, определяющий атрибуты безопасности данного потока. Если эта величина равна нулю, то создаваемый поток имеет те же атрибуты безопасности, что и вызывающий поток.

Описание
Данная функция позволяет создать новый поток. Первая версия данной функции создает рабочий поток. Вторая версия создает интерфейсный поток. Функция AfxBeginThread создает новый объект класса CWinThread, вызывает функциюCreateThread для начала исполнения потока, а также возвращает указатель на созданный объект класса потока. В процессе выполнения данной функции производятся все проверки, необходимые для того, чтобы гарантировать, что в случае возникновения ошибки в процессе выполнения данной функции все созданные до этого объекты будут соответствующим образом уничтожены. Для завершения работы потока следует вызвать функцию AfxEndThread из данного потока или выйти из исполняющей функции потока.
AfxCheckError

void AFXAPI AfxCheckError(SCODE sc); throw CMemoryException* throw COleException* Описание

Данная функция проверяет значение своего аргумента на то, что он содержит код ошибки. В случае положительного исхода этой проверки вызывается исключение. Если в качестве аргумента передан код E_OUTOFMEMORY, вызывается исключениеCMemoryException. Для этого используется функция AfxThrowMemoryException. В противном случае, с использованием функции AfxThrowOleException, вызывается исключение COleException. Функция AfxCheckError одинаково работает как в отладочной, так и в распространяемой версиях приложения.
AfxCheckMemory

BOOL AfxCheckMemory();

Возвращаемое значение
Ненулевое, при отсутствии ошибок в памяти, и нулевое в противном случае.
Описание
Данная функция проверяет кучу и выводит сообщения об обнаруженных ошибках. Если ошибки отсутствуют, ничего не выводится. Производится проверка всех блоков памяти, размещенных в куче, включая блоки, выделенные операцией new. Блоки, выделенные на низком уровне, например, функциями malloc и GlobalAlloc, не проверяются. Список дефектных блоков памяти выводится в окно отладчика. Если в программе присутствует строка

#define new DEBUG_NEW

то при последующих вызовах функции AfxCheckMemory в выводимую информацию будет включено имя файла и номер строки, в которой был выделен этот блок памяти. Если приложение содержит классы, сохраняемые в потоке, то приведенная выше строка должно располагаться после последнего вызова макроса IMPLEMENT_SERIAL. Эта функция работает только в отладочной версии библиотеки MFC.
AfxDumpStack

void AFXAPI AfxDumpStack(DWORD dwTarget = AFX_STACK_DUMP_TARGET_DEFAULT);

Аргументы

dwTarget - указывает, куда будет записываться содержимое стека. Может представлять собой комбинацию следующих значений, объединяемых операцией ИЛИ (|):
       AFX_STACK_DUMP_TARGET_TRACE - для вывода содержимого стека используется макрос TRACE. Этот макрос выводит информацию только в отладочном режиме. В окончательной версии никакой информации выводиться не будет. Выходной поток макроса TRACE может быть переназначен другому приемнику, помимо отладчика;
       AFX_STACK_DUMP_TARGET_DEFAULT - при работе отладочной версии содержимое стека выводится макросом TRACE, а в окончательной версии оно помещается в буфер обмена;
       AFX_STACK_DUMP_TARGET_CLIPBOARD - помещает содержимое стека в буфер обмена. Запись производится в текстовом виде с использованием формата буфера обмена CF_TEXT;
       AFX_STACK_DUMP_TARGET_BOTH - помещает содержимое стека в буфер обмена и одновременно выводит его макросом TRACE;
       AFX_STACK_DUMP_TARGET_ODS - посылает содержимое стека непосредственно отладчику с использованием функции Win32 OutputDebugString. Отладчик, если он подключен к процессу, получит эту информацию как от отладочной, так и от окончательной версии. При установке флага AFX_STACK_DUMP_TARGET_ODS приемником информации может быть только отладчик (если он подключен).

Описание
Данная функция используется для создания образа стека. Каждой функции, содержащейся в стеке, соответствует строка в его образе. Каждая строка образа стека содержит адрес последнего вызова функции, полный путь к модулю, в котором произошел вызов и прототип вызываемой функции. Если вызов функции произошел не по указанному адресу, дополнительно указывается смещение вызова (в результате вызов может произойти не из указанной функции, а совсем из другой функции). Данная функция имеется как в отладочной, так и в распространяемой версиях библиотеки MFC. Эта функция всегда подключается статически. Даже в тех случаях, когда все остальные функции библиотеки MFC подключаются динамически. В этом случае ее реализация располагается в файле MFCS42.LIB или в его вариантах. Для обеспечения успешной работы данной функции необходимо обеспечить следующие условия:

приложение должно иметь доступ к каталогу, в котором расположен файл imagehlp.dll. В противном случае будет выдано сообщение об ошибке. Этот файл представляет собой библиотеку динамической компоновки, поставляемую совместно с Platform SDK и Windows; располагающиеся в стеке модули должны содержать отладочную информацию. В противном случае выдаваемая данной функцией информация будет не столь детальной.

AfxEnableControlContainer

void AfxEnableControlContainer();

Описание
Данная функция вызывается функцией CWinApp::InitInstance, чтобы обеспечить в приложении поддержку элементов управления OLE.
AfxEnableMemoryTracking

BOOL AfxEnableMemoryTracking(BOOL bTrack);

Возвращаемое значение
Возвращает предыдущее значение флага разрешения проверки памяти.
Аргументы

bTrack - флаг разрешения проверки памяти.

Описание
Позволяет установить или отменить режим трассировки памяти. По умолчанию в отладочной версии приложения MFC установлен режим проверки памяти. Чтобы отменить этот режим, достаточно вызвать функцию AfxEnableMemoryTracking с аргументом FALSE. Для восстановления этого режима необходимо передать в аргументе данной функции значение TRUE. Эта функция работает только в отладочной версии библиотеки MFC.
AfxEndThread

void AfxEndThread(UINT nExitCode);

Аргументы

nExitCode - определяет код завершения потока.

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

BOOL GetMessage(LPMSG lpMsg, HWND hWnd, UINT wMsgFilterMin, UINT wMsgFilterMax);

Возвращаемое значение
Если данная функция извлекает сообщение отличное от WM_QUIT, то возвращается ненулевая величина. В противном случае возвращается ноль. Если в процессе выполнения функции произошла ошибка, то возвращаемая величина равна -1. Например, ошибка может возникнуть, если аргумент hWnd не является дескриптором окна или аргумент lpMsg не указывает на объект структуры MSG. Дополнительную информацию по ошибке можно получить, вызвав функцию GetLastError.
Аргументы

lpMsg - указатель на объект структуры MSG, в который будет записана информация из очереди сообщений потока.
hWnd - дескриптор окна, сообщения для которого следует получить. Этот аргумент может принимать нулевое значение. Это значение свидетельствует о том, что функция GetMessage должна получать сообщения для любого окна, принадлежащего данному потоку, и сообщения от потока, посланные функцией PostThreadMessage.
wMsgFilterMin - определяет нижнюю границу диапазона отыскиваемых сообщений.
wMsgFilterMax - определяет верхнюю границу диапазона отыскиваемых сообщений.

Описание
Функция GetMessage получает сообщения из очереди сообщений вызвавшего ее потока и помещает их в объект специальной структуры. Данная функция позволяет получать сообщения для любого окна, принадлежащего данному потоку, и сообщения от потока, посланные функцией PostThreadMessage. При поиске сообщений производится проверка на нахождение их в определенном диапазоне значений. Функция GetMessage не может отыскивать сообщения, направленные другим окнам или приложениям. Приложение использует возвращаемое данной функцией значение для определения того, нет ли необходимости выйти из главного цикла сообщений приложения и завершить его работу. Функция GetMessage позволяет получить сообщения, связанные с окном, определенным в аргументе hWnd, или с любым его дочерним окном, как это определено в функции IsChild. Получаемые сообщения должны находиться в диапазоне, заданном аргументами wMsgFilterMin иwMsgFilterMax. Если аргумент hWnd имеет нулевое значение, то функция GetMessage должна получать сообщения для любого окна, принадлежащего данному потоку, и сообщения от потока, посланные функцией PostThreadMessage. Даже в том случае, когда аргумент hWnd имеет нулевое значение, функция GetMessage не позволяет получать сообщения, предназначенные для окон, принадлежащих другим потокам, или от других потоков, кроме вызывающего. Сообщение от потока, направляемое функцией PostThreadMessage имеет нулевое значение параметра hWnd. Если оба аргумента wMsgFilterMin и wMsgFilterMax имеют нулевое значение, то функция GetMessage позволяет получить все возможные сообщения (фильтрация сообщений отсутствует). В качестве границ диапазона могут использоваться значения WM_KEYFIRST и WM_KEYLAST, позволяющие выделить все сообщения, связанные с клавиатурой, и значения WM_MOUSEFIRST и WM_MOUSELAST, позволяющие выделить все сообщения, связанные с мышью. Функция GetMessage не удаляет сообщение WM_PAINT из очереди сообщений. Оно остается там пока не будет обработано. Поскольку данная функция может возвращать положительные, нулевые и отрицательные значения, то при написании программы следует избегать использования таких выражений как:

while (GetMessage(lpMsg, hWnd, 0, 0)) {
...
}

поскольку данное выражение не реагирует на величину -1, свидетельствующую о возникновении фатальной ошибки в приложении.
GetWindowContextHelpId

DWORD GetWindowContextHelpId(HWND hwnd);

Возвращаемое значение
Возвращает контекстный идентификатор справки, если такой идентификатор связан с данным окном, и ноль в противном случае.
Аргументы

hwnd - дескриптор окна, для которого необходимо получить контекстный идентификатор справки.

Описание
Позволяет получить контекстный идентификатор справки для указанного окна, если с данным окном связан контекстный идентификатор справки.
GetWindowRect

BOOL GetWindowRect(HWND hWnd, LPRECT lpRect);

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

hWnd - дескриптор окна.
lpRect - указатель на объект структуры RECT, содержащий экранные координаты верхнего левого и нижнего правого углов окна.

Описание
Функция GetWindowRect позволяет получить координаты прямоугольника, описывающего указанное окно. Координаты окна измеряются в экранных координатах, нулевая точка которых расположена в левом верхнем углу экрана.
HtmlHelp

HWND HtmlHelp(HWND hwndCaller, LPCSTR pszFile, UINT uCommand, DWORD dwData);

Возвращаемое значение
Дескриптор окна, в котором будет выводиться справочная информация.
Аргументы

hwndCaller - дескриптор окна, для которого вызывается справочная система.
pszFile - определяет файл HTML, URL, компилированный файл справочной системы HTML или определение окна (предваряемое символом '>'). Если используемая команда не предполагает использования файла или URL, может принимать нулевое значение.
uCommand - содержит выполняемую команду. Список команд приведен в примечании.
dwData - содержит информацию, используемую командой, определенной в аргументе uCommand.

Описание
Данная функция используется для вывода справочной информации в формате HTML. Создаваемое ею окно справочной системы является дочерним окном того окна, дескриптор которого передан в качестве аргумента данной функции, автоматически отображается поверх родительского окна и закрывается вместе с ним. Если справочная система будет посылать сообщения, они будут направляться родительскому окну. Для создаваемого окна могут быть заданы стили, координаты, заголовок и режим отображения. Как уже говорилось выше, аргумент uCommand функции HtmlHelp определяет операцию, производимую данной функцией. Эта операция определяет тип файла, передаваемого в аргументе pszFile, и информацию, передаваемую в аргументе dwData данной функции. Список команд и содержимое аргументов приведены в таблице П2.1.

Таблица П2.1. Команды функции HtmlHelp

Команда Описание Содержимое аргумента pszFile Содержимое аргумента dwData
HH_DISPLAY_TOPIC Выводит файл HTML. Если тип окна не определен, используется окно, определенное по умолчанию. Если окно уже выведено, файл HTML заменяет его содержимое. Файл, URL или скомпилированный файл HTML. Если в этом аргументе присутствует символ '>' за ним следует определение типа окна, в которое будет выводиться справочная информация. Может содержать указатель на файл, URL, скомпилированный файл HTML или имя файла в имя скомпилированном файле HTML, на который указывает аргумент pszFile. Указатель может быть нулевым.
HH_DISPLAY_TEXT_POPUP Выводит текст из строкового ресурса, текстовой строки или текстового файла во всплывающее окно. Имя текстового файла или нулевое значение, если текст содержится в строковом ресурсе или объекте структуры HH_POPUP. Указатель на объект структуры HH_POPUP.
HH_SET_WIN_TYPE Создает новый или изменяет существующий тип окна. Игнорируется. Указатель на объект структуры HH_WINTYPE.
HH_GET_WIN_TYPE Позволяет получить объект структуры HH_WINTYPE, связанный с типом окна. Если указанный тип окна не определен, возвращает значение 1. Если указанный тип окна определен, возвращает дескриптор окна (если окно не создано, возвращает нулевое значение). Содержит имя окна. Это имя должно начинаться с символа '>', перед которым может располагаться имя скомпилированного файла HTML. Адрес указателя на объект структуры PHH_WINTYPE. В полученный объект структуры нельзя вносить изменения.
HH_GET_WIN_HANDLE Получает дескриптор окна, связанного с указанным типом окна. Если указанный тип окна не определен, возвращает нулевое значение. Игнорируется Указатель на строку, содержащую имя типа окна.
HH_SET_INFO_TYPES Устанавливает все типы информации, которые будут выводиться в данном окне. В окне, содержащем три панели, это приведет к перерисовке навигационной панели (если она отображается). Игнорируется Указатель на объект структуры HH_WINTYPE. В этом объекте структуры должны быть заполнены переменные cbStruct и ainfoTypes.
HH_SYNC Синхронизирует оглавление в окне, содержащем три панели, с указанным URL. Эта команда используется только в окнах, не поддерживающих автоматическую синхронизацию. Содержит имя синхронизируемого окна. Содержит синхронизирующий URL, который может в настоящее время и не выводиться.
HH_ADD_NAV_UI Добавляет окно навигации в навигационную панель окна, содержащего три панели. Указатель на функцию HhWinCallBack, поддерживающую новый UI. Уникальный числовой идентификатор нового UI. Переключение между UI осуществляется изменением значения переменной curNavType объекта структуры HH_WINTYPE.
HH_ADD_BUTTON Добавляет кнопку в панель инструментов окна, содержащего три панели. Указатель на функцию HhWinCallBack, поддерживающую новую кнопку. Уникальный числовой идентификатор новой кнопки.
HH_KEYWORD_LOOKUP Производит поиск указанного ключевого слова в файле .hhk. При его обнаружении соответствующая тема выводится в указанном (или в текущем, если не указано) окне. Если содержит нулевое значение, поиск производится в файле .hhk, связанным с текущим окном. Если содержит строку, содержащую описание окна, поиск производится в файле .hhk, связанным с данным окном. В нем же будут отображаться найденные темы. Если указан файл .hhk, то поиск будет производиться в этом файле, а отображение - в текущем окне. Указатель на строку, содержащую одно или несколько ключевых слов, разделенных точкой с запятой (;).