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

Статья
08/28/2023

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

Синтаксис

BOOL WTSRegisterSessionNotificationEx(
  [in] HANDLE hServer,
  [in] HWND   hWnd,
  [in] DWORD  dwFlags
);

Параметры

[in] hServer

Дескриптор сервера, возвращенного из WTSOpenServer или WTS_CURRENT_SERVER.

[in] hWnd

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

[in] dwFlags

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

NOTIFY_FOR_THIS_SESSION (0)

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

NOTIFY_FOR_ALL_SESSIONS (1)

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

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

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll