função PSPropertyBag_ReadStream (propsys.h)
Lê o fluxo de dados armazenado em uma determinada propriedade contida em um recipiente de propriedades especificado.
Sintaxe
PSSTDAPI PSPropertyBag_ReadStream(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] IStream **value
);
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.
[out] value
Tipo: IStream**
O endereço de um ponteiro que, quando essa função retorna com êxito, recebe o objeto IStream .
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
O chamador da função PSPropertyBag_ReadStream precisa chamar um método IUnknown::Release no objeto IStream retornado por essa função.
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) |