Metodo IScanProfile::SetProperty

Imposta il valore delle proprietà figlio specificate nell'elemento <Properties> di un profilo di analisi.

Sintassi

HRESULT SetProperty(
  [in] ULONG       num,
  [in] PROPID      *pid,
  [in] PROPVARIANT *pvar
);

Parametri

num [in]

Tipo: ULONG

Numero di voci nelle matrici a cui punta pid e pvar.

pid [in]

Tipo: PROPID*

Puntatore a una matrice di numeri di identificazione delle proprietà da impostare. Ogni valore nella matrice è una costante della proprietà WIA.

pvar [in]

Tipo: PROPVARIANT*

Puntatore a una matrice di valori da assegnare alle proprietà.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Ogni valore nella matrice a cui pid punta è una delle costanti della proprietà WIA. È possibile estendere questo sistema di identificazione. Vedere Definizione di proprietà personalizzate.

Le modifiche apportate a un profilo non vengono salvate su disco finché l'applicazione non chiama il metodo IScanProfile::Save .

Se due applicazioni creano oggetti profilo di analisi dallo stesso file XML e ogni applicazione scrive le modifiche apportate al relativo oggetto, solo le modifiche apportate dall'applicazione che chiama IScanProfile::Save last vengono salvate su disco.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Scanprofile.h
IDL	Scanprofiles.idl

Vedi anche

IScanProfile

Informazioni concettuali

Schema del profilo di analisi

Costanti delle proprietà WIA

Definizione di proprietà personalizzate