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

Die Delete-Methode löscht angegebene Eigenschaften aus einem angegebenen Objekt auf einem Gerät.

Syntax

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

Parameter

[in] pszObjectID

Zeiger auf eine NULL-beendete Zeichenfolge, die die ID des Objekts angibt, dessen Eigenschaften Sie löschen. Verwenden Sie zum Angeben des Geräts WPD_DEVICE_OBJECT_ID.

[in] pKeys

Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die angibt, welche Eigenschaften gelöscht werden sollen. Eine Liste der von tragbaren Windows-Geräten definierten Eigenschaften finden Sie unter Eigenschaften und Attribute.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
S_FALSE	Mindestens ein Eigenschaftswert konnte nicht gelöscht werden.
E_POINTER	Das erforderliche Zeigerargument war NULL.

Hinweise

Eigenschaften können nur gelöscht werden, wenn ihr WPD_PROPERTY_ATTRIBUTE_CAN_DELETE Attribut True ist. Dieses Attribut kann durch Aufrufen von GetPropertyAttributes abgerufen werden.

Der Treiber hat keine Möglichkeit, einen Teilerfolg anzugeben; Das heißt, wenn nur einige Eigenschaften gelöscht werden könnten, gibt der Treiber S_FALSE zurück, aber diese Methode gibt nicht an, welche Eigenschaften erfolgreich gelöscht wurden. Die einzige Möglichkeit, zu erfahren, welche Eigenschaften gelöscht wurden, besteht darin, alle Eigenschaften anzufordern, indem Sie IPortableDeviceProperties::GetValues aufrufen.

Anforderungen

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

Weitere Informationen

IPortableDeviceProperties-Schnittstelle