Função wiasGetPropertyAttributes (wiamdef.h)

Artigo
02/07/2025

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

Sintaxe

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        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 de PROPSPEC indicando as propriedades para as quais obter valores válidos e sinalizadores de acesso.

pulAccessFlags

Ponteiro para uma matriz que contém os sinalizadores de acesso para as propriedades.

[out] pPropVar

Ponteiro para uma matriz de estruturas PROPVARIANT que contém os valores válidos para as propriedades.

Valor de retorno

Com êxito, a função retorna S_OK.

Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia .

Observações

Essa função preenche cada elemento da matriz de pPropVar com uma estrutura PROPVARIANT que especifica os valores válidos para a propriedade correspondente. As propriedades com o sinalizador de direitos de acesso WIA_PROP_NONE não têm valores válidos para essa propriedade. O tipo de dados para os valores válidos dessas propriedades é VT_EMPTY.

Um ou mais atributos de propriedade WIA_PROP_Xxx e sinalizadores de acesso podem ser retornados em cada elemento da matriz pulAccessFlags.

Se a propriedade tiver um intervalo de valores válidos, os valores poderão ser determinados por meio do parâmetro pPropVar após a conclusão dessa função. O parâmetro pPropVar especifica uma matriz de estruturas PROPVARIANT.

Valores inteiros válidos e de ponto flutuante em um intervalo são acessados usando as seguintes constantes de índice.

Índice de valor válido	Descrição
WIA_RANGE_MIN	Valor mínimo
WIA_RANGE_NOM	Valor nominal
WIA_RANGE_MAX	Valor máximo
WIA_RANGE_STEP	Valor de incremento

Os valores de lista válidos são acessados usando as seguintes constantes de índice.

Índice de valor válido	Descrição
WIA_LIST_COUNT	Contagem de valores de lista válidos, sem contar o valor nominal
WIA_LIST_NOM	Valor nominal
WIA_LIST_VALUES	Indexar para o primeiro valor válido

Os valores de sinalizador bit a bit válidos são acessados usando as seguintes constantes de índice.

Índice de valor válido	Descrição
WIA_FLAG_NOM	Valor nominal
WIA_FLAG_VALUES	Todos os sinalizadores válidos são unidos por um operador OR

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wiamdef.h (inclua Wiamdef.h)
biblioteca	Wiaservc.lib
de DLL	Wiaservc.dll

Partilhar via