iWMDMProgress3：：End3 方法 (mswmdm.h)

發行項
03/13/2024

End3 方法是由 Windows Media 裝置管理員呼叫，表示作業已完成。這個方法會藉由為事件的識別 (標識碼) 和命令內容的指標提供額外的輸入參數，來擴充 IWMDMProgress2：：End2 。

語法

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

參數

[in] EventId

指定結束事件的 GUID 。下表顯示可能的值。

事件	描述
SCP_EVENTID_ACQSECURECLOCK	Windows Media 裝置管理員會從伺服器取得安全時鐘。
SCP_EVENTID_NEEDTOINDIV	裝置正在個別化。目前未使用這個值。
SCP_EVENTID_DRMINFO	此事件識別碼可用來向應用程式通知應用程式，其版本DRM標頭位於每個檔案的內容中。傳回的 OPAQUECOMMAND 結構已將 guidCommand 成員設定為 SCP_PARAMID_DRMVERSION。此外，數據會指定下列其中一個旗標： WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	正在傳送內容到裝置或從裝置傳送。

[in] hrCompletionCode

HRESULT 指定進行中作業的完成碼。 hrCompletionCode 參數是結束之作業的傳回碼。此參數可以是任何 HRESULT，包括標準 COM 錯誤碼、轉換成 HRESULT 的 Win32 錯誤碼，或 Windows Media 裝置管理員錯誤碼。

[in, out] pContext

OPAQUECOMMAND 結構的指標，其中包含直接傳送至裝置的命令，而不需由 Windows Media 裝置管理員處理。這個參數是選擇性的，而且可以是 NULL。內容結構是元件將事件傳送至應用程式之任何相關數據的方法。傳送此結構的元件應該定義應用程式如何解譯此數據結構。

傳回值

Windows Media 裝置管理員會忽略 End3 方法傳回的任何傳回碼，因為呼叫此方法之前，目前作業已完成或取消。

備註

擁有實作作業之方法的介面會在方法所定義的作業完成時呼叫 End3 。

範例

下列 C++ 程式代碼示範 End3 的範例實作。


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}