Função wiasReadMultiple (wiamdef.h)

Artigo
02/07/2025

A função wiasReadMultiple recupera vários valores de propriedade de um item WIA.

Sintaxe

HRESULT wiasReadMultiple(
  [in]            BYTE           *pWiasContext,
                  ULONG          ulCount,
  [in]            const PROPSPEC *ps,
  [out]           PROPVARIANT    *pv,
  [out, optional] PROPVARIANT    *pvOld
);

Parâmetros

[in] pWiasContext

Ponteiro para um contexto de item WIA.

ulCount

Especifica o número de propriedades a serem lidas.

[in] ps

Ponteiro para o primeiro elemento de uma matriz de estruturas de PROPSPEC, contendo as propriedades a serem lidas.

[out] pv

Ponteiro para o primeiro elemento de uma matriz de estruturas PROPVARIANT. Após o retorno, essas estruturas contêm novos valores para as propriedades.

[out, optional] pvOld

Ponteiro para o primeiro elemento de uma matriz de estruturas PROPVARIANT alocadas anteriormente pelo minidriver. Após o retorno, a matriz contém os valores anteriores dos dados da propriedade. Se essas informações não forem necessárias, esse parâmetro poderá ser definido como NULL.

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 lê várias propriedades de um item WIA. Quando a chamada for bem-sucedida, o minidriver deverá chamar propVariantClear em cada elemento na matriz especificada pelo parâmetro pv. Consulte IPropertyStorage::ReadMultiple para obter mais informações.

Requisitos

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

Consulte também

wiasWriteMultiple

Compartilhar via