WTSRegisterSessionNotification 함수(wtsapi32.h)

아티클
03/04/2024

세션 변경 알림을 받을 지정된 창을 등록합니다.

구문

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
헤더	wtsapi32.h
라이브러리	Wtsapi32.lib
DLL	Wtsapi32.dll
API 세트	ext-ms-win-session-wtsapi32-l1-1-0(Windows 8 도입)