IPortableDeviceContent::Move-Methode (portabledeviceapi.h)

Artikel
03/04/2024

Die Move-Methode verschiebt ein oder mehrere Objekte von einem Standort auf dem Gerät an einen anderen.

Syntax

HRESULT Move(
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in]      LPCWSTR                              pszDestinationFolderObjectID,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Parameter

[in] pObjectIDs

Zeiger auf eine IPortableDevicePropVariantCollection-Schnittstelle , die mindestens eine null-beendete Zeichenfolge enthält (Typ VT_LPWSTR), die die Objekt-IDs der zu verschiebenden Objekte angibt.

[in] pszDestinationFolderObjectID

Zeiger auf eine NULL-Zeichenfolge, die die ID des Ziels angibt.

[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 in ppResults zurückgegebene Element dem zweiten Objekt in der pObjectIDs-Auflistung usw. Dieser Parameter kann NULL sein, wenn sich die Anwendung nicht um die Ergebnisse handelt.

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 wurde gelöscht, aber mindestens ein Objekt konnte nicht gelöscht werden. Unter ppFailedObjectIDs erfahren Sie, welche Objekte nicht gelöscht wurden.
E_ACCESSDENIED	Die Anwendung verfügt nicht über die Rechte zum Verschieben des Objekts.
E_POINTER	Mindestens eines der erforderlichen Argumente war ein NULL-Zeiger .

Hinweise

Wenn das angegebene Gerät Verschiebevorgänge in einem funktionalen Speicher unterstützt, kann der PszDestinationFolderObjectID-Parameter den Bezeichner für einen funktionalen Speicher angeben.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Verschieben von Inhalten auf dem Gerät.

Anforderungen

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

Weitere Informationen

IPortableDeviceContent-Schnittstelle

Verschieben von Inhalten auf dem Gerät

Freigeben über