função PSPropertyBag_ReadUnknown (propsys.h)

Lê uma determinada propriedade de um valor de dados desconhecido em um recipiente de propriedades.

Sintaxe

PSSTDAPI PSPropertyBag_ReadUnknown(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [in]  REFIID       riid,
  [out] void         **ppv
);

Parâmetros

[in] propBag

Tipo: IPropertyBag*

Um ponteiro para um objeto IPropertyBag , que representa o recipiente de propriedades no qual a propriedade é armazenada.

[in] propName

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres de nome de propriedade terminada em nulo.

[in] riid

Tipo: REFIID

Uma referência ao IID da interface a ser recuperada por meio de ppv. Essa IID de interface deve ser IPropertyBag ou uma interface derivada de IPropertyBag.

[out] ppv

Tipo: void**

Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, isso é riid.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IPropertyBag e IPersistPropertyBag otimizam a funcionalidade Salvar como Texto. IPropertyBag e IPropertyBag2 fornecem um objeto com um recipiente de propriedades no qual o objeto pode salvar suas propriedades persistentemente. IPropertyBag2 permite que o objeto obtenha informações de tipo para cada propriedade: IPropertyBag2::Read faz com que uma ou mais propriedades sejam lidas do recipiente de propriedades e IPropertyBag2::Write faz com que uma ou mais propriedades sejam salvas no recipiente de propriedades.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	propsys.h
Biblioteca	Propsys.lib
DLL	Propsys.dll (versão 6.0 ou posterior)

Confira também

PSPropertyBag_WriteUnknown