ID2D1Properties::SetValueByName(PCWSTR,constT&) -Methode (d2d1_1.h)

Legt die benannte Eigenschaft auf den angegebenen Wert fest. Dies ist eine Vorlagenüberladung. Siehe Anmerkungen.

Syntax

HRESULT SetValueByName(
  [in]      PCWSTR    propertyName,
  [in, ref] const T & value
);

[in] propertyName

Der Name der festzulegenden Eigenschaft.

[in, ref] value

Die festzulegenden Daten. Die Methode konvertiert diesen Typ in ein BYTE*, bevor er als Eigenschaftswert festgelegt wird.

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

HRESULT	Beschreibung
S_OK	Es ist kein Fehler aufgetreten.
D2DERR_INVALID_PROPERTY	Die angegebene Eigenschaft ist nicht vorhanden.
E_OUTOFMEMORY	Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
D3DERR_OUT_OF_VIDEO_MEMORY	Fehler beim Zuordnen des erforderlichen Videospeichers.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_FAIL	Nicht angegebener Fehler.

template<typename T>
    HRESULT SetValueByName(
        _In_ PCWSTR propertyName,
        _In_ const T &value
        );

Anforderung	Wert
mindestens unterstützte Client-	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	d2d1_1.h
Library	D2d1.lib
DLL-	D2d1.dll