Método IScanProfile::SetProperty
Define o valor das propriedades filho especificadas no <Properties> elemento de um perfil de verificação.
Sintaxe
HRESULT SetProperty(
[in] ULONG num,
[in] PROPID *pid,
[in] PROPVARIANT *pvar
);
Parâmetros
-
núm [in]
-
Tipo: ULONG
O número de entradas nas matrizes que são apontadas por pid e pvar.
-
pid [in]
-
Tipo: PROPID*
Um ponteiro para uma matriz de números de identificação das propriedades a serem definidas. Cada valor na matriz é uma constante de propriedade WIA.
-
pvar [in]
-
Tipo: PROPVARIANT*
Um ponteiro para uma matriz de valores a serem atribuídos às propriedades.
Valor retornado
Tipo: HRESULT
Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
Cada valor na matriz para a qual o pid aponta é uma das Constantes de Propriedade WIA. Você pode estender esse sistema de identificação. Consulte Definindo propriedades personalizadas.
As alterações em um perfil não são salvas no disco até que o aplicativo chame o método IScanProfile::Save .
Se dois aplicativos criarem objetos de perfil de verificação do mesmo arquivo XML e cada aplicativo gravar alterações em seu objeto, somente as alterações feitas pelo aplicativo que chama IScanProfile::Save last serão salvas no disco.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|
Confira também
-
Conceitual