共用方式為


iWMDMOperation::End 方法 (mswmdm.h)

End 方法指出讀取或寫入作業是否已完成,不論是否成功,都會傳回完成程序代碼。

語法

HRESULT End(
  [in] HRESULT  *phCompletionCode,
  [in] IUnknown *pNewObject
);

參數

[in] phCompletionCode

作業的完成程序代碼。

[in] pNewObject

傳送至裝置時,指向新 IWMDMStorage 物件的指標,代表已傳送至裝置的新物件。 從裝置讀取時,從裝置讀取的 IWMDMStorage 物件的指標。

傳回值

方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別:

  • 標準 COM 錯誤碼
  • 轉換成 HRESULT 值的 Windows 錯誤碼
  • Windows Media 裝置管理員 錯誤碼
如需可能錯誤碼的廣泛清單,請參閱 錯誤碼

備註

不論傳輸是否成功,呼叫 End 方法,而且是最後一個 呼叫的 IWMDMOperation 方法。 這個方法可用來向應用程式發出訊號,以關閉讀取或寫入作業所需的所有檔句柄和其他物件。

範例

下列 C++ 程式代碼會在讀取或寫入動作之後關閉全域檔句柄,並輸出訊息。


HRESULT End(HRESULT* phCompletionCode, IUnknown* pNewObject)
{
    // TODO: Display the message: "IWMDMOperation event--End."

    // Close the file handle now that we're done with it.
    if (m_File != INVALID_HANDLE_VALUE)
        if (!CloseHandle(m_File))
            // TODO: Display the message: "Couldn't close the file."

    // Reset global status flag.
    m_OperationStatus = OPERATION_UNINITIALIZED;
    return S_OK;
}

規格需求

需求
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

手動處理檔案傳輸

IWMDMOperation 介面