Функция GetGUIThreadInfo


Функция GetGUIThreadInfo извлекает информацию об активном окне или заданном потоке графического интерфейса пользователя (GUI).

Синтаксис

BOOL GetGUIThreadInfo (

DWORD idThread,
LPGUITHREADINFO
lpgui

);

Параметры

idThread

[in] Идентифицирует поток, информация о котором должна быть получена. Чтобы извлечь это значение, используйте функцию GetWindowThreadProcessId. Если этот параметр имеет значение ПУСТО (NULL), функции возвращает информацию о приоритетном потоке.

lpgui

[out] Указатель на структуру GUITHREADINFO, которая получает информацию, описывающую поток. 

Обратите внимание! на то, что Вы должны перед вызовом этой функции член структуры GUITHREADINFO.cbSize установить в sizeof (GUITHREADINFO).

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

Если функция завершается успешно, величина возвращаемого значения - не ноль.

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

Замечания

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

Эта функция полезна для восстановления вне контекстной информации о потоке. Извлеченная информация является той же самой, как если бы приложение извлекло информацию о себе.

Смотри также

Краткий обзор Окна, GetCursorInfo, GetWindowThreadProcessId, GUITHREADINFO

Размещение и совместимость GetGUIThreadInfo

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 4.0 SP3 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Нет

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz