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


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

Объявляет один удаляемый элемент.

Синтаксис

HRESULT DeleteItem(
  [in] IShellItem                 *psiItem,
  [in] IFileOperationProgressSink *pfopsItem
);

Параметры

[in] psiItem

Тип: IShellItem*

Указатель на элемент IShellItem , указывающий удаляемый элемент.

[in] pfopsItem

Тип: IFileOperationProgressSink*

Указатель на объект IFileOperationProgressSink , который будет использоваться для уведомления о состоянии выполнения и уведомления об ошибках для конкретной операции удаления. Если вы вызываете IFileOperation::Advise для общей операции, в нее включаются сведения о состоянии хода выполнения и уведомления об ошибках для операции удаления, поэтому задайте для этого параметра значение NULL.

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

Тип: HRESULT

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

Комментарии

Этот метод не удаляет элемент, он просто объявляет элемент для удаления. Чтобы удалить элемент, необходимо выполнить по крайней мере последовательность вызовов, подробно описанную здесь:

  1. Вызовите метод IFileOperation::D eleteItem , чтобы объявить удаленный файл или папку.
  2. Вызовите метод IFileOperation::P erformOperations , чтобы начать операцию удаления.

Требования

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

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

IFileOperation

IFileOperation::D eleteItems

PostDeleteItem

PreDeleteItem