funzione PSPropertyBag_ReadStream (propsys.h)

Legge il flusso di dati archiviato in una determinata proprietà contenuta in un contenitore di proprietà specificato.

Sintassi

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

Parametri

[in] propBag

Tipo: IPropertyBag*

Puntatore a un oggetto IPropertyBag che rappresenta il contenitore delle proprietà in cui viene archiviata la proprietà.

[in] propName

Tipo: LPCWSTR

Puntatore a una stringa di nome della proprietà con terminazione null.

[out] value

Tipo: IStream**

L'indirizzo di un puntatore che, quando questa funzione restituisce correttamente, riceve l'oggetto IStream .

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il chiamante della funzione PSPropertyBag_ReadStream deve chiamare un metodo IUnknown::Release nell'oggetto IStream restituito da questa funzione.

IPropertyBag e IPersistPropertyBag ottimizzano la funzionalità Salva come testo. IPropertyBag e IPropertyBag2 forniscono un oggetto con un contenitore di proprietà in cui l'oggetto può salvare le relative proprietà in modo permanente. IPropertyBag2 consente all'oggetto di ottenere informazioni sul tipo per ogni proprietà: IPropertyBag2:: Read causa la lettura di una o più proprietà dal contenitore delle proprietà e IPropertyBag2::Write causa il salvataggio di una o più proprietà nel contenitore delle proprietà.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)

Vedi anche

PSPropertyBag_WriteStream