IPortableDeviceProperties::SetValues-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die SetValues-Methode fügt eine oder mehrere Eigenschaften für ein angegebenes Objekt auf einem Gerät hinzu oder ändert sie.

Syntax

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

Parameter

[in] pszObjectID

Zeiger auf eine NULL-endende Zeichenfolge, die die Objekt-ID des zu ändernden Objekts enthält. Verwenden Sie zum Angeben des Geräts WPD_DEVICE_OBJECT_ID.

[in] pValues

Zeiger auf eine IPortableDeviceValues-Schnittstelle , die ein oder mehrere festzulegende Eigenschafts-Wert-Paare enthält. Vorhandene Werte werden überschrieben.

[out] ppResults

Adresse einer Variablen, die einen Zeiger auf eine IPortableDeviceValues-Schnittstelle empfängt , die eine Auflistung von Eigenschafts-/HRESULT-Werten enthält. Jeder Wert (Typ VT_ERROR) beschreibt den Erfolg oder Fehler des Eigenschaftssatzversuchs. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie damit fertig ist.

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	Alle angegebenen Eigenschaftswerte wurden aktualisiert.
S_FALSE	Mindestens eine Eigenschaft konnte nicht geändert werden. Diejenigen, die nicht konnten, verfügen über ein HRESULT vom Typ VT_ERROR im abgerufenen ppResults-Parameter .

Hinweise

Um eine Eigenschaft zu löschen, rufen Sie IPortableDeviceProperties::D elete auf. Eine Eigenschaft kann nur gelöscht werden, wenn ihr WPD_PROPERTY_ATTRIBUTE_CAN_WRITE-Attribut True ist. Dieses Attribut kann durch Aufrufen von GetPropertyAttributes abgerufen werden.