Функция WTSRegisterSessionNotification (wtsapi32.h)

Статья
08/28/2023

Регистрирует указанное окно для получения уведомлений об изменениях сеанса.

Синтаксис

BOOL WTSRegisterSessionNotification(
  [in] HWND  hWnd,
  [in] DWORD dwFlags
);

Параметры

[in] hWnd

Дескриптор окна для получения уведомлений об изменениях сеанса.

[in] dwFlags

Указывает, какие уведомления о сеансе должны быть получены. Этот параметр может принимать одно из указанных ниже значений.

NOTIFY_FOR_THIS_SESSION

Будут получены только уведомления о сеансе, присоединенном к окну, определенному значением параметра hWnd .

NOTIFY_FOR_ALL_SESSIONS

Все уведомления о сеансе должны быть получены.

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

Если функция выполнена успешно, возвращается значение TRUE. В противном случае — FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Если эта функция вызывается до запуска зависимых служб удаленных рабочих столов, может быть возвращен RPC_S_INVALID_BINDING код ошибки. При установке глобального события Global\TermSrvReadyEvent запущены все зависимые службы, и эту функцию можно успешно вызвать.

Уведомления об изменениях сеанса отправляются в виде сообщения WM_WTSSESSION_CHANGE . Эти уведомления отправляются только тем окнам, которые зарегистрированы для них с помощью этой функции.

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

Если дескриптор окна, переданный в этой функции, уже зарегистрирован, значение параметра dwFlags игнорируется.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll
Набор API	ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8)