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
Library Mssachlp.lib

另请参阅

手动处理文件传输

IWMDMOperation 接口