IRecordInfo::P utField-Methode (oaidl.h)

Artikel
03/04/2024

Fügt eine Variante in ein Feld ein.

Syntax

HRESULT PutField(
  [in]      ULONG     wFlags,
  [in, out] PVOID     pvData,
  [in]      LPCOLESTR szFieldName,
  [in]      VARIANT   *pvarField
);

Parameter

[in] wFlags

Die einzigen zulässigen Werte für den wFlags-Parameter sind INVOKE_PROPERTYPUT oder INVOKE_PROPERTYPUTREF.

Wenn INVOKE_PROPERTYPUTREF übergeben wird, weist PutField einfach den Wert der Variante zu, die mithilfe normaler Koersionsregeln an das Feld übergeben wird.

Wenn INVOKE_PROPERTYPUT übergeben wird, gelten bestimmte Regeln. Wenn das Feld als von IDispatch abgeleitete Klasse deklariert wird und der Wert des Felds NULL ist, wird ein Fehler zurückgegeben. Wenn der Wert des Felds nicht NULL ist, wird die Variante an die Standardeigenschaft übergeben, die vom Objekt unterstützt wird, auf das das Feld verweist. Wenn das Feld nicht als von IDispatch abgeleitete Klasse deklariert ist, wird ein Fehler zurückgegeben. Wenn das Feld als Variante des Typs VT_Dispatch deklariert wird, wird dem Feld der Standardwert des Objekts zugewiesen. Andernfalls wird dem Feld der Wert der Variante zugewiesen.

[in, out] pvData

Der Zeiger auf eine instance des Datensatzes.

[in] szFieldName

Der Name des Felds des Datensatzes.

[in] pvarField

Der Zeiger auf die Variante.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Mindestens eines der Argumente ist ungültig.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	oaidl.h

Weitere Informationen

IRecordInfo

Freigeben über