Metodo IPropertyBag::Read (oaidl.h)

Articolo
08/25/2023

Legge la proprietà denominata in un valore VARIANT inizializzato dal chiamante.

Sintassi

HRESULT Read(
  LPCOLESTR pszPropName,
  VARIANT   *pVar,
  IErrorLog *pErrorLog
);

Parametri

pszPropName

Indirizzo del nome della proprietà da leggere. Non può essere NULL.

pVar

Indirizzo del chiamante inizializzato VARIANT che riceve il valore della proprietà nell'output. La funzione imposta il campo di tipo e il campo valore nell'oggetto VARIANT prima che venga restituito. Se il chiamante ha inizializzato il pVar->vt campo sulla voce, il contenitore delle proprietà tenta di modificare il valore corrispondente in questo tipo. Se il chiamante imposta pVar->vt su VT_EMPTY, il contenitore delle proprietà può usare qualsiasi tipo sia pratico.

pErrorLog

Indirizzo del log degli errori del chiamante in cui il contenitore delle proprietà archivia eventuali errori che si verificano durante le letture. Può essere NULL; in questo caso, il chiamante non riceve errori.

Valore restituito

An HRESULT

Commenti

Il metodo Read indica al contenitore delle proprietà di leggere la proprietà denominata in pszPropName nel metodo VARIANT inizializzato dal chiamante in pVar. Gli errori vengono registrati nel log degli errori a cui punta pErrorLog. Quando pVar->vt specifica un altro puntatore a oggetti (VT_UNKNOWN), il contenitore delle proprietà è responsabile della creazione e dell'inizializzazione dell'oggetto descritto da pszPropName.

E_NOTIMPL non è un codice restituito valido, perché qualsiasi oggetto che implementa questa interfaccia deve supportare l'intera funzionalità dell'interfaccia.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	oaidl.h

Condividi tramite