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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Mindestens ein Eigenschaftswert konnte nicht gelöscht werden. |
|
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 |