ID2D1Properties::GetValueByName(PCWSTR,T*)-Methode (d2d1_1.h)

Ruft den Eigenschaftswert anhand des Namens ab. Dies ist eine Vorlagenüberladung. Siehe Anmerkungen.

Syntax

HRESULT GetValueByName(
  [in]  PCWSTR propertyName,
  [out] T      *value
);

[in] propertyName

Typ: PCWSTR-

Der abzurufende Eigenschaftsname.

[out] value

Typ: T*

Wenn diese Methode zurückgegeben wird, enthält sie den Wert.

Typ: HRESULT-

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.

Wenn propertyName- nicht vorhanden ist, werden keine Informationen abgerufen.

Jeder Fehler, der nicht im von einer Eigenschaftsimplementierung zurückgegebenen Standardsatz ist, wird dem Standardfehlerbereich zugeordnet.

template<typename T>
    HRESULT GetValueByName(
        _In_ PCWSTR propertyName,
        _Out_ T *value
        ) const;

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