Metodo ISensor::SetProperties (sensorsapi.h)

Importante

Usare invece l'API sensore UWP .

L'API del sensore basata su COM è deprecata e non deve essere usata nelle nuove applicazioni. Non sono pianificate funzionalità o miglioramenti aggiuntivi e il supporto sarà limitato.

Specifica le proprietà del sensore.

Sintassi

HRESULT SetProperties(
  [in]  IPortableDeviceValues *pProperties,
  [out] IPortableDeviceValues **ppResults
);

Parametri

[in] pProperties

Puntatore a un'interfaccia IPortableDeviceValues contenente l'elenco di proprietà e valori da impostare.

[out] ppResults

Indirizzo di un'interfaccia IPortableDeviceValues che riceve l'elenco delle proprietà impostate correttamente. Ogni proprietà ha un valore HRESULT associato, che indica se l'impostazione della proprietà è riuscita.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Codice restituito	Description
S_OK	Il metodo è riuscito.
S_FALSE	Richiesta di impostazione di una o più proprietà specificate non riuscita. Esaminare ppResults per determinare quali proprietà, se presenti, hanno avuto esito positivo.
E_POINTER	NULL è stato passato per ppResults.

Osservazioni:

Questo metodo consente di specificare i valori di una o più proprietà, ad esempio la creazione del sensore, il modello e il numero di serie, effettuando una singola chiamata.

Non tutte le proprietà possono essere impostate.

IPortableDeviceValues è definito dall'API Dispositivi portatili Windows.

Esempi

Per un esempio di come impostare le proprietà, vedere Impostazione e recupero delle proprietà del sensore.

Requisiti

Requisito	Value
Client minimo supportato	Windows 7 [solo applicazioni desktop]
Server minimo supportato	Nessuna supportata
Piattaforma di destinazione	Windows
Header	sensorsapi.h
Library	Sensorsapi.lib
DLL	Sensorsapi.dll

Vedere anche

GetProperties

ISensor