Compartilhar via


Função wiasReadMultiple (wiamdef.h)

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 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.

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 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
Plataforma de Destino Área de Trabalho
Cabeçalho wiamdef.h (inclua Wiamdef.h)
Biblioteca Wiaservc.lib
DLL Wiaservc.dll

Confira também

wiasWriteMultiple