Compartilhar via


Método IWiaPropertyStorage::GetPropertyStream (wia_xp.h)

O método IWiaPropertyStorage::GetPropertyStream recupera o fluxo de propriedades de um item.

Sintaxe

HRESULT GetPropertyStream(
  [out] GUID    *pCompatibilityId,
  [out] IStream **ppIStream
);

Parâmetros

[out] pCompatibilityId

Tipo: GUID*

Recebe um identificador exclusivo para um conjunto de valores de propriedade.

[out] ppIStream

Tipo: IStream**

Ponteiro para um fluxo que recebe as propriedades do item. Para obter mais informações, consulte IStream.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os aplicativos usam esse método para obter um instantâneo das propriedades atuais de um item. Eles são restaurados posteriormente chamando IWiaPropertyStorage::SetPropertyStream.

Os aplicativos podem usar o parâmetro pCompatibilityID para marcar se um dispositivo der suporte a um conjunto específico de valores de propriedade antes de tentar gravar esses valores no dispositivo.

Quando terminar de usar o fluxo de propriedades do item, o aplicativo deverá liberá-lo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib
DLL Wiaservc.dll

Confira também

IPropertyStorage

IWiaPropertyStorage