다음을 통해 공유


WTSRegisterSessionNotification 함수(wtsapi32.h)

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

구문

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 도입)

추가 정보

HandlerEx

WM_WTSSESSION_CHANGE

WTSGetActiveConsoleSessionId

WTSRegisterSessionNotificationEx

WTSSESSION_NOTIFICATION

WTSUnRegisterSessionNotification