BroadcastSystemMessage 함수(winuser.h)

지정된 받는 사람에게 메시지를 보냅니다. 수신자는 애플리케이션, 설치 가능한 드라이버, 네트워크 드라이버, 시스템 수준 디바이스 드라이버 또는 이러한 시스템 구성 요소의 조합일 수 있습니다.

요청이 정의된 경우 추가 정보를 받으려면 BroadcastSystemMessageEx 함수를 사용합니다.

구문

long BroadcastSystemMessage(
  [in]                DWORD   flags,
  [in, out, optional] LPDWORD lpInfo,
  [in]                UINT    Msg,
  [in]                WPARAM  wParam,
  [in]                LPARAM  lParam
);

매개 변수

[in] flags

형식:DWORD

브로드캐스트 옵션입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

[in, out, optional] lpInfo

형식: LPDWORD

메시지의 받는 사람에 대한 정보를 포함하고 받는 변수에 대한 포인터입니다.

함수가 반환될 때 이 변수는 실제로 메시지를 받은 받는 사람을 식별하는 이러한 값의 조합을 받습니다.

이 매개 변수가 NULL이면 함수는 모든 구성 요소로 브로드캐스트됩니다.

이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

[in] Msg

형식: UINT

보낼 메시지입니다.

시스템 제공 메시지 목록은 시스템 정의 메시지를 참조하세요.

[in] wParam

형식: WPARAM

추가 메시지 관련 정보입니다.

[in] lParam

형식: LPARAM

추가 메시지 관련 정보입니다.

반환 값

형식: long

함수가 성공하면 반환 값은 양수 값입니다.

함수가 메시지를 브로드캐스트할 수 없는 경우 반환 값은 –1입니다.

dwFlags 매개 변수가 BSF_QUERY 하나 이상의 받는 사람이 해당 메시지에 BROADCAST_QUERY_DENY 반환되는 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

BSF_QUERY 지정하지 않으면 함수는 요청된 모든 받는 사람에게 지정된 메시지를 보내고 해당 받는 사람이 반환한 값을 무시합니다.

시스템은 시스템 메시지(0~(WM_USER-1) 범위의 메시지)에 대해서만 마샬링을 수행합니다. 다른 메시지(그 >= WM_USER)를 다른 프로세스로 보내려면 사용자 지정 마샬링을 수행해야 합니다.

예제

예제는 프로세스 종료를 참조하세요.

요구 사항

참고 항목

BroadcastSystemMessageEx

개념

메시지 및 메시지 큐

참조

SendNotifyMessage