funzione PSPropertyBag_ReadType (propsys.h)

Articolo
08/25/2023

Legge il tipo di valore dei dati di una proprietà archiviata in un contenitore delle proprietà.

Sintassi

PSSTDAPI PSPropertyBag_ReadType(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] VARIANT      *var,
  [out] VARTYPE      type
);

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] var

Tipo: VARIANT*

Restituisce al completamento della funzione un puntatore a un tipo di dati VARIANT contenente il valore della proprietà.

[out] type

Tipo: VARTYPE*

Se il tipo è VT_EMPTY, questa funzione legge VARIANT della proprietà nel parametro propBag IPropertyBag. Se il tipo non è VT_EMPTY e non uguale alla lettura VARIANT , questa funzione tenta di convertire la lettura VARIANT in VARTYPE definita dal parametro di tipo prima di restituire.

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


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_Delete

Condividi tramite