IPortableDeviceContent::D elete-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die Delete-Methode löscht mindestens ein Objekt vom Gerät.

Syntax

HRESULT Delete(
  [in]      const DWORD                          dwOptions,
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Parameter

[in] dwOptions

Einer der DELETE_OBJECT_OPTIONS Enumeratoren.

[in] pObjectIDs

Zeiger auf eine IPortableDevicePropVariantCollection-Schnittstelle , die eine oder mehrere null-endende Zeichenfolgen enthält (Typ VT_LPWSTR), die die Objekt-IDs der zu löschenden Objekte angeben.

[in, out] ppResults

Optional. Bei der Rückgabe enthält dieser Parameter eine Auflistung von VT_ERROR Werten, die den Erfolg oder Fehler des Vorgangs angeben. Das erste in ppResults zurückgegebene Element entspricht dem ersten Objekt in der pObjectIDs-Auflistung , das zweite Element, das in ppResults zurückgegeben wird, dem zweiten Objekt in der pObjectIDs-Auflistung usw. Dieser Parameter kann NULL sein, wenn die Anwendung sich nicht mit den Ergebnissen befasst.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Wenn ein Fehlerwert zurückgegeben wird, wurden keine Objekte auf dem Gerät gelöscht.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
S_FALSE	Mindestens ein Objekt konnte nicht gelöscht werden. Der ppResults-Parameter enthält, sofern angegeben, den Fehlercode pro Objekt.
E_XXXXXXXX	Der Treiber hat keine Objekte gelöscht.
E_INVALIDARG	Für dwOptions wurde ein ungültiger Wert angegeben.
E_ACCESSDENIED	Die Anwendung verfügt nicht über die Berechtigung zum Löschen des Objekts.
HRESULT_FROM_WIN32(ERROR_DIR_NOT_EMPTY)	Der angegebene Ordner oder das angegebene Verzeichnis konnte nicht gelöscht werden, da es nicht leer war.
HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION)	Die angegebene Anwendung PORTABLE_DEVICE_DELETE_NO_RECURSION, und das Objekt verfügt über untergeordnete Elemente.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Das Objekt konnte nicht gelöscht werden, da es auf dem Gerät nicht vorhanden ist.

Hinweise

Rufen Sie IPortableDeviceCapabilities::GetCommandOptions auf, um festzustellen, ob das rekursive Löschen unterstützt wird. Wenn die abgerufene IPortableDeviceValues-Schnittstelle einen Eigenschaftswert namens WPD_OPTION_OBJECT_MANAGEMENT_RECURSIVE_DELETE_SUPPORTED mit dem boolVal-Wert True enthält, unterstützt das Gerät rekursives Löschen.

In der folgenden Tabelle sind die möglichen Rückgabecodes aufgeführt, die in der Auflistung angezeigt werden können, an der ppResults verweist.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Löschen von Inhalten vom Gerät.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

Löschen von Inhalten vom Gerät

IPortableDeviceContent-Schnittstelle

Freigeben über