IPortableDeviceContent::Move-Methode (portabledeviceapi.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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. |
|
Die Anwendung verfügt nicht über die Rechte zum Verschieben des Objekts. |
|
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 |