Metodo IPortableDeviceProperties::SetValues (portabledeviceapi.h)

Articolo
03/15/2023

Il metodo SetValues aggiunge o modifica una o più proprietà in un oggetto specificato in un dispositivo.

Sintassi

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

Parametri

[in] pszObjectID

Puntatore a una stringa con terminazione Null contenente l'ID oggetto dell'oggetto da modificare. Per specificare il dispositivo, usare WPD_DEVICE_OBJECT_ID.

[in] pValues

Puntatore a un'interfaccia IPortableDeviceValues che contiene una o più coppie di proprietà/valore da impostare. I valori esistenti verranno sovrascritti.

[out] ppResults

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDeviceValues che contiene una raccolta di valori property/HRESULT. Ogni valore (tipo VT_ERROR) descrive l'esito positivo o negativo del tentativo del set di proprietà. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Tutti i valori delle proprietà specificati sono stati aggiornati.
S_FALSE	Impossibile modificare una o più proprietà. Quelli che non possono avere un valore HRESULT di tipo VT_ERROR nel parametro ppResults recuperato.

Commenti

Per eliminare una proprietà, chiama IPortableDeviceProperties::D elete. Una proprietà può essere eliminata solo se il relativo attributo WPD_PROPERTY_ATTRIBUTE_CAN_WRITE è True. Questo attributo può essere recuperato chiamando GetPropertyAttributes.