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) |