función PSPropertyBag_ReadStream (propsys.h)

Lee el flujo de datos almacenado en una propiedad determinada contenida en un contenedor de propiedades especificado.

Sintaxis

PSSTDAPI PSPropertyBag_ReadStream(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] IStream      **value
);

Parámetros

[in] propBag

Tipo: IPropertyBag*

Puntero a un objeto IPropertyBag , que representa el contenedor de propiedades en el que se almacena la propiedad.

[in] propName

Tipo: LPCWSTR

Puntero a una cadena de nombre de propiedad terminada en null.

[out] value

Tipo: IStream**

La dirección de un puntero que, cuando esta función devuelve correctamente, recibe el objeto IStream .

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El autor de la llamada de la función PSPropertyBag_ReadStream debe llamar a un método IUnknown::Release en el objeto IStream devuelto por esta función.

IPropertyBag e IPersistPropertyBag optimizan la funcionalidad Guardar como texto. IPropertyBag e IPropertyBag2 proporcionan un objeto con un contenedor de propiedades en el que el objeto puede guardar sus propiedades de forma persistente. IPropertyBag2 permite al objeto obtener información de tipo para cada propiedad: IPropertyBag2::Read hace que una o varias propiedades se lean desde el contenedor de propiedades y IPropertyBag2::Write hace que una o varias propiedades se guarden en el contenedor de propiedades.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h
Library	Propsys.lib
Archivo DLL	Propsys.dll (versión 6.0 o posterior)

Consulte también

PSPropertyBag_WriteStream