MI_Context_WriteMessage 함수(mi.h)

클라이언트에 운영 메시지를 보냅니다.

구문

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_WriteMessage(
  [in] MI_Context    *context,
       MI_Uint32     channel,
       const MI_Char *message
);

매개 변수

[in] context

요청 컨텍스트.

channel

쓸 채널입니다. 클라이언트는 다음 채널 중 하나를 선택할 수 있습니다.

MI_WRITEMESSAGE_CHANNEL_WARNING (0)

경고 메시지를 브로드캐스트하는 데 사용되는 채널입니다.

MI_WRITEMESSAGE_CHANNEL_VERBOSE (1)

자세한 정보 메시지를 브로드캐스트하는 데 사용되는 채널입니다.

MI_WRITEMESSAGE_CHANNEL_DEBUG (2)

디버깅 정보를 브로드캐스트하는 데 사용되는 채널입니다.

message

클라이언트로 보낼 메시지를 나타내는 null로 끝나는 문자열입니다. 경고 또는 자세한 정보 표시인 경우 메시지를 지역화해야 합니다.

반환 값

함수 반환 코드를 지정하는 MI_Result 열거형의 값입니다. 다음 코드 중 하나일 수 있습니다.

설명

작동 메시지를 클라이언트에 보내야 하는 경우 공급자는 이 함수를 호출합니다. 작동 메시지의 예는 클라이언트가 UI를 업데이트할 수 있도록 장기 실행 삭제 프로세스에서 삭제된 파일을 클라이언트에 알리는 것입니다. 공급자의 진행 속도를 늦출 수 있으므로 이 함수를 과도하게 사용하지 않도록 주의해야 합니다. 클라이언트는 필요에 따라 비동기 콜백을 통해 이러한 메시지를 수신하도록 등록할 수 있습니다. 클라이언트가 이러한 메시지에 등록하지 않으면 서버는 메시지를 무시합니다.

요구 사항

참고 항목

MI_Context