Метод IWMDMOperation::End (mswmdm.h)

Статья
08/25/2023

Метод End указывает, что операция чтения или записи завершена, успешно или нет, и возвращает код завершения.

Синтаксис

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

Параметры

[in] phCompletionCode

Код завершения операции.

[in] pNewObject

При отправке на устройство — указатель на новый объект IWMDMStorage , представляющий новый объект, отправленный на устройство. При чтении с устройства — указатель на объект IWMDMStorage , который был считан с устройства.

Возвращаемое значение

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств 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
Header	mswmdm.h
Библиотека	Mssachlp.lib

См. также раздел

Обработка передачи файлов вручную

Интерфейс IWMDMOperation

Поделиться через