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