Compartilhar via


Função wiasGetPropertyAttributes (wiamdef.h)

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 PROPSPEC que indica 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.

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 códigos de erro WIA.

Comentários

Essa função preenche cada elemento da matriz 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 Índice 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
Plataforma de Destino Área de Trabalho
Cabeçalho wiamdef.h (inclua Wiamdef.h)
Biblioteca Wiaservc.lib
DLL Wiaservc.dll