Partager via


Méthode IScanProfile::SetProperty

Définit la valeur des propriétés enfants spécifiées dans l’élément <Properties> d’un profil d’analyse.

Syntaxe

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

Paramètres

num [in]

Type : ULONG

Nombre d’entrées dans les tableaux qui sont pointées par pid et pvar.

pid [in]

Type : PROPID*

Pointeur vers un tableau de numéros d’identification des propriétés à définir. Chaque valeur du tableau est une constante de propriété WIA.

pvar [in]

Type : PROPVARIANT*

Pointeur vers un tableau de valeurs à affecter aux propriétés.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Notes

Chaque valeur du tableau vers laquelle pid pointe est l’une des constantes de propriété WIA. Vous pouvez étendre ce système d’identification. Consultez Définition de propriétés personnalisées.

Les modifications apportées à un profil ne sont pas enregistrées sur le disque tant que l’application n’appelle pas la méthode IScanProfile::Save .

Si deux applications créent des objets de profil d’analyse à partir du même fichier XML et que chaque application écrit des modifications dans son objet, seules les modifications apportées par l’application qui appelle IScanProfile::Save last sont enregistrées sur le disque.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]
En-tête
Scanprofile.h
IDL
Scanprofiles.idl

Voir aussi

IScanProfile

Conceptuel

Schéma de profil d’analyse

Constantes de propriété WIA

Définition de propriétés personnalisées