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 |