funzione PSPropertyBag_ReadUnknown (propsys.h)

Articolo
03/13/2024

Legge una determinata proprietà di un valore dati sconosciuto in un contenitore di proprietà.

Sintassi

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

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.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv. Questo IID di interfaccia deve essere IPropertyBag o un'interfaccia derivata da IPropertyBag.

[out] ppv

Tipo: void**

Quando questo metodo restituisce correttamente, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere riid.

Valore restituito

Tipo: HRESULT

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

Commenti

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_WriteUnknown

Condividi tramite