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;
}

要件

こちらもご覧ください

ファイル転送を手動で処理する

IWMDMOperation インターフェイス