IFileOperation::D eleteItem-Methode (shobjidl_core.h)

  • Artikel

Deklariert ein einzelnes Element, das gelöscht werden soll.

Syntax

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

Parameter

[in] psiItem

Typ: IShellItem*

Zeiger auf ein IShellItem, das das zu löschende Element angibt.

[in] pfopsItem

Typ: IFileOperationProgressSink*

Zeiger auf ein IFileOperationProgressSink-Objekt, das für den Fortschritt status und Fehlerbenachrichtigungen für diesen spezifischen Löschvorgang verwendet werden soll. Wenn Sie IFileOperation::Advise für den Gesamtvorgang aufrufen, sind dort fortschritts- status und Fehlerbenachrichtigungen für den Löschvorgang enthalten. Legen Sie daher diesen Parameter auf NULL fest.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode löscht das Element nicht, sondern deklariert lediglich das zu löschende Element. Um ein Element zu löschen, müssen Sie mindestens die hier beschriebene Reihenfolge der Aufrufe ausführen:

  1. Rufen Sie IFileOperation::D eleteItem auf, um die zu löschende Datei oder den Ordner zu deklarieren.
  2. Rufen Sie IFileOperation::P erformOperations auf , um den Löschvorgang zu starten.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IFileOperation

IFileOperation::D eleteItems

PostDeleteItem

PreDeleteItem