Compartilhar via


Método IItemPropertyBag::Read

Faz com que uma ou mais propriedades sejam lidas do recipiente de propriedades. A interface IItemPropertyBag tem suporte apenas no Windows XP e no Windows Server 2003 e não deve mais ser usada.

Sintaxe

HRESULT Read(
  [in]  ULONG    cProperties,
  [in]  ITEMPROP *pPropBag,
  [out] VARIANT  *pvarValue,
  [out] HRESULT  *phrError
);

Parâmetros

cProperties [in]

O número de propriedades a serem lidas. Esse argumento especifica o número de elementos nas matrizes em pPropBag, pvarValue e phrError.

pPropBag [in]

Ponteiro para uma matriz de estruturas ITEMPROP que especifica as propriedades solicitadas.

pvarValue [out]

Recebe um ponteiro que retorna uma matriz de estruturas VARIANT que recebe os valores da propriedade.

phrError [out]

Ponteiro para uma matriz de valores HRESULT que recebe o resultado de cada propriedade lida. Deve haver pelo menos elementos cProperties nessa matriz.

Valor retornado

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

Comentários

A interface IItemPropertyBag tem suporte apenas no Windows XP e no Windows Server 2003 e não deve mais ser usada.

Para visualizar anexos com um manipulador de protocolo de terceiros em computadores que executam o Windows XP ou o Windows Server 2003, talvez seja necessário usar a interface IItemPropertyBag e as seguintes APIs: as interfaces ISearchProtocolUI, IItemPreviewerExt e ISearchItem , as estruturas LINKINFO e ITEMPROP e a enumeração LINKTYPE .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Redistribuível
Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

IItemPropertyBag