External.OnSendMessageComplete 이벤트

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

참고

이 항목에서는 온라인 스토어에서 사용하도록 설계된 기능에 대해 설명합니다. 온라인 스토어의 컨텍스트 외부에서는 이 기능을 사용할 수 없습니다.

OnSendMessageComplete 이벤트는 온라인 스토어에서 메시지 처리를 완료할 때 발생합니다. 검색 페이지의 스크립트는 이전에 External.sendMessage를 호출하여 메시지를 보냈습니다.

window.external.OnSendMessageComplete = FunctionName

가능한 값

이벤트가 발생할 때 호출할 Windows 미디어 플레이어 스크립트에서 함수의 이름을 지정하는 쓰기 전용 속성입니다.

매개 변수

이 이벤트를 처리하는 함수에는 다음과 같은 매개 변수가 있습니다.

메시지

sendMessage의 Msg 매개 변수에 전달된 것과 동일한 문자열입니다.

Param

sendMessage의 Param 매개 변수에 전달된 것과 동일한 문자열입니다.

결과

메시지 처리 결과를 포함하는 문자열입니다. 설명 부분을 참조하세요.

설명

sendMessage 메서드는 비동기적으로 반환되는 IWMPContentPartner::SendMessage를 호출합니다. 즉, 온라인 저장소가 메시지 처리를 완료하기 전에 반환됩니다. 온라인 저장소에서 메시지 처리를 마치면 IWMPContentPartnerCallback::SendMessageComplete를 호출하며, 이 호출은 스크립트의 OnSendMessageComplete 이벤트 처리기를 호출합니다.

온라인 저장소가 IWMPContentPartnerCallback::SendMessageComplete를 호출하면 bstrResult 매개 변수에 결과 코드가 제공됩니다. Windows 미디어 플레이어 해당 결과 코드를 해석하지 않습니다. 대신 Windows 미디어 플레이어 Result 매개 변수의 OnSendMessageComplete 이벤트 처리기에 결과 코드를 전달합니다.

OnSendMessageComplete 이벤트 처리기의 매개 변수(Msg, Param, Result)는 Windows 미디어 플레이어 해석되지 않습니다. 매개 변수는 온라인 스토어에만 의미가 있습니다.

요구 사항

요구 사항	값
버전	Windows 미디어 플레이어 11
DLL	Wmp.dll

추가 정보

유형 1 온라인 저장소에 대한 외부 개체

External.sendMessage

IWMPContentPartner::SendMessage

IWMPContentPartnerCallback::SendMessageComplete