WTSSendMessageA 함수(wtsapi32.h)

아티클
08/28/2023

지정된 원격 데스크톱 서비스 세션의 클라이언트 데스크톱에 메시지 상자를 표시합니다.

구문

BOOL WTSSendMessageA(
  [in]  HANDLE hServer,
  [in]  DWORD  SessionId,
  [in]  LPSTR  pTitle,
  [in]  DWORD  TitleLength,
  [in]  LPSTR  pMessage,
  [in]  DWORD  MessageLength,
  [in]  DWORD  Style,
  [in]  DWORD  Timeout,
  [out] DWORD  *pResponse,
  [in]  BOOL   bWait
);

매개 변수

[in] hServer

RD 세션 호스트 서버에 대한 핸들입니다. WTSOpenServer 함수에서 연 핸들을 지정하거나 WTS_CURRENT_SERVER_HANDLE 지정하여 애플리케이션이 실행 중인 RD 세션 호스트 서버를 나타냅니다.

[in] SessionId

원격 데스크톱 서비스 세션 식별자입니다. 현재 세션을 나타내려면 WTS_CURRENT_SESSION 지정합니다. WTSEnumerateSessions 함수를 사용하여 지정된 RD 세션 호스트 서버에서 모든 세션의 식별자를 검색할 수 있습니다.

다른 사용자의 세션에 메시지를 보내려면 메시지 권한이 있어야 합니다. 자세한 내용은 원격 데스크톱 서비스를 참조 하세요.
사용 권한을 클릭합니다. 세션에 대한 권한을 수정하려면 원격 데스크톱 서비스 구성 관리 도구를 사용합니다.

[in] pTitle

메시지 상자의 제목 표시줄에 대한 null로 끝나는 문자열에 대한 포인터입니다.

[in] TitleLength

제목 표시줄 문자열의 길이(바이트)입니다.

[in] pMessage

표시할 메시지를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] MessageLength

메시지 문자열의 길이(바이트)입니다.

[in] Style

메시지 상자의 내용과 동작입니다. 이 값은 일반적으로 MB_OK. 전체 값 목록은 MessageBox 함수의 uType 매개 변수를 참조하세요.

[in] Timeout

WTSSendMessage 함수가 사용자의 응답을 기다리는 시간(초)입니다. 사용자가 제한 시간 간격 내에 응답하지 않으면 pResponse 매개 변수는 IDTIMEOUT을 반환합니다. Timeout 매개 변수가 0이면 WTSSendMessage는 사용자가 응답할 때까지 무기한 대기합니다.

[out] pResponse

다음 값 중 하나일 수 있는 사용자의 응답을 받는 변수에 대한 포인터입니다.

IDABORT (3)

중단

IDCANCEL(2)

취소

IDCONTINUE (11)

계속

IDIGNORE (5)

무시

IDNO(7)

아니요

IDOK(1)

확인

IDRETRY (4)

다시 시도

IDTRYAGAIN (10)

다시 한 번 시도해 보세요

IDYES(6)

예

IDASYNC(32001(0x7D01))

bWait 매개 변수는 FALSE이므로 함수는 응답을 기다리지 않고 반환됩니다.

IDTIMEOUT(32000(0x7D00))

bWait 매개 변수가 TRUE이고 제한 시간 간격이 경과했습니다.

[in] bWait

TRUE이면 사용자가 응답하거나 시간 제한 간격이 경과할 때까지 WTSSendMessage가 반환되지 않습니다. Timeout 매개 변수가 0이면 사용자가 응답할 때까지 함수가 반환되지 않습니다.

FALSE이면 함수가 즉시 반환되고 pResponse 매개 변수는 IDASYNC를 반환합니다. 호출 프로그램에 대한 사용자의 응답을 반환할 필요가 없는 간단한 정보 메시지(예: 작업-알림 메시지 인쇄)에 이 메서드를 사용합니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

참고

wtsapi32.h 헤더는 WTSSendMessage를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wtsapi32.h
라이브러리	Wtsapi32.lib
DLL	Wtsapi32.dll

추가 정보

MessageBox