IPropertyBag::Read-Methode (oaidl.h)

Liest die benannte Eigenschaft in einen vom Aufrufer initialisierten VARIANT.

Syntax

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

Parameter

pszPropName

Die Adresse des Namens der zu lesenden Eigenschaft. Dies kann nicht NULL sein.

pVar

Die Adresse des vom Aufrufer initialisierten VARIANT, der den Eigenschaftswert bei der Ausgabe empfängt. Die Funktion legt das Feld typ und das Wertfeld im VARIANT fest, bevor sie zurückgegeben wird. Wenn der Aufrufer das pVar->vt Feld beim Eintrag initialisiert hat, versucht der Eigenschaftenbehälter, den entsprechenden Wert in diesen Typ zu ändern. Wenn der Aufrufer auf VT_EMPTY festgelegt ist pVar->vt , kann der Eigenschaftenbehälter den gewünschten Typ verwenden.

pErrorLog

Die Adresse des Fehlerprotokolls des Aufrufers, in dem der Eigenschaftenbehälter alle Fehler speichert, die beim Lesen auftreten. Dies kann NULL sein. In diesem Fall erhält der Aufrufer keine Fehler.

Rückgabewert

Ein HRESULT

Hinweise

Die Read-Methode weist den Eigenschaftenbehälter an, die Eigenschaft namens in pszPropName an den aufruferinitialisierten VARIANT in pVar zu lesen. Fehler werden im Fehlerprotokoll protokolliert, auf das pErrorLog verweist. Wenn pVar->vt ein anderer Objektzeiger (VT_UNKNOWN) angegeben wird, ist der Eigenschaftenbehälter für das Erstellen und Initialisieren des von pszPropName beschriebenen Objekts verantwortlich.

E_NOTIMPL ist kein gültiger Rückgabecode, da jedes Objekt, das diese Schnittstelle implementiert, die gesamte Funktionalität der Schnittstelle unterstützen muss.

Anforderungen