IInspectable::GetRuntimeClassName-Methode (inspectable.h)

  • Artikel

Ruft den vollqualifizierten Namen des aktuellen Windows-Runtime-Objekts ab.

Syntax

HRESULT GetRuntimeClassName(
  [out] HSTRING *className
);

Parameter

[out] className

Typ: HSTRING*

Der vollqualifizierte Name des aktuellen Windows-Runtime-Objekts.

Rückgabewert

Typ: HRESULT

Diese Funktion kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die className-Zeichenfolge wurde erfolgreich erstellt.
E_OUTOFMEMORY
 Fehler beim Zuweisen der className-Zeichenfolge .
E_ILLEGAL_METHOD_CALL
 className bezieht sich auf eine Klassenfactory oder eine statische Schnittstelle.

Hinweise

Verwenden Sie die GetRuntimeClassName-Methode, um den namespacequalifizierten Namen eines Windows-Runtime-Objekts abzurufen.

Der Aufrufer ist für das Freigeben der className-Zeichenfolge mit der WindowsDeleteString-Funktion verantwortlich.

Die folgende Tabelle zeigt Beispielklassennamenzeichenfolgen, die von der GetRuntimeClassName-Methode zurückgegeben werden können.

Beispielklassenname BESCHREIBUNG
Fabrikam.Kitchen.IToaster Eine Schnittstelle im Namespace Fabrikam.Kitchen.
Fabrikam.Kitchen.Chef Eine Klasse im Namespace Fabrikam.Kitchen.
Windows.Foundation.Collections.IVector'1<TailspinToys.IStore> Ein Vektor von TailspinToys.IStore-Schnittstellen.
Windows.Foundation.Collections.IVector'1<Windows.Foundation.Collections.IMap'2<String, TailspinToys.IStore>> Ein Vektor von Zuordnungen von Zeichenfolgen zu TailspinToys.IStore-Schnittstellen.
 

Die GetRuntimeClassName-Methode stellt die spezifischsten Typinformationen bereit, die das Serverobjekt für die Implementierung garantiert. Der Typname kann ein Laufzeitklassenname, Schnittstellengruppenname, Schnittstellenname oder parametrisierter Schnittstellenname sein.

Die GetRuntimeClassName-Methode gibt E_ILLEGAL_METHOD_CALL zurück, wenn der Klassenname auf eine Klassenfactory oder eine statische Schnittstelle verweist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile inspectable.h

Weitere Informationen

IInputPaneInterop

IInspectable

winrt::get_class_name