IFileOperation::D eleteItem-Methode (shobjidl_core.h)
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:
- Rufen Sie IFileOperation::D eleteItem auf, um die zu löschende Datei oder den Ordner zu deklarieren.
- 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) |