Compartilhar via


Função wiasSetPropertyAttributes (wiamdef.h)

A função wiasSetPropertyAttributes define os sinalizadores de acesso e os valores válidos para um conjunto de propriedades.

Sintaxe

HRESULT wiasSetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
  [in]  ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

Parâmetros

[in] pWiasContext

Ponteiro para um contexto de item WIA.

cPropSpec

Especifica o número de propriedades.

[in] pPropSpec

Ponteiro para uma estrutura PROPSPEC que indica as propriedades para as quais definir valores válidos e sinalizadores de acesso.

[in] pulAccessFlags

Ponteiro para uma matriz que contém os sinalizadores de acesso a serem gravados.

[out] pPropVar

Ponteiro para uma matriz de estruturas PROPVARIANT que contém os valores válidos a serem gravados.

Retornar valor

Em caso de êxito, a função retorna S_OK. Se a função falhar, ela retornará um erro COM padrão ou um dos erros de WIA_ERROR_XXX (descritos na documentação do SDK do Microsoft Windows).

Comentários

Os minidrivers devem usar a função wiasSetItemPropAttribs para inicializar grupos de propriedades simples.

O minidriver pode definir o sinalizador WIA_PROP_CACHEABLE em uma propriedade que não é alterada ao longo do tempo. Ao definir esse sinalizador em uma propriedade, o minidriver indica que o serviço WIA pode armazenar em cache o valor da propriedade. Consulte a documentação do SDK do Windows para obter uma lista de todos os atributos de propriedade.

As estruturas PROPSPEC e PROPVARIANT são definidas na documentação do SDK do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows Me e no Windows XP e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wiamdef.h (inclua Wiamdef.h)
Biblioteca Wiaservc.lib
DLL Wiaservc.dll

Confira também

wiasSetItemPropAttribs