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

Метод IFileOperation::Advise (shobjidl_core.h)

  • Статья

Позволяет обработчику предоставлять сведения о состоянии и ошибках для всех операций.

Синтаксис

HRESULT Advise(
  [in]  IFileOperationProgressSink *pfops,
  [out] DWORD                      *pdwCookie
);

Параметры

[in] pfops

Тип: IFileOperationProgressSink*

Указатель на объект IFileOperationProgressSink , который будет использоваться для уведомлений о состоянии выполнения и ошибках.

[out] pdwCookie

Тип: DWORD*

При возвращении этого метода этот параметр указывает на возвращенный маркер, который однозначно идентифицирует это соединение. Вызывающее приложение использует этот маркер позже для удаления подключения, передав его в IFileOperation::Unadvise. Если вызов метода Совет завершается ошибкой, это значение не имеет смысла.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Несколько отдельных методов имеют возможность объявлять собственные приемники хода выполнения, которые являются избыточными в этом наборе. Они используются, когда требуется предоставить сведения о ходе выполнения и ошибках только для конкретной операции.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)

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

IFileOperation

IFileOperation::Unadvise