Méthode IInspectable ::GetRuntimeClassName (inspectable.h)

  • Article

Obtient le nom complet de l’objet Windows Runtime actuel.

Syntaxe

HRESULT GetRuntimeClassName(
  [out] HSTRING *className
);

Paramètres

[out] className

Type : HSTRING*

Nom complet de l’objet Windows Runtime actuel.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner les valeurs suivantes.

Code de retour Description
S_OK
 La chaîne className a été créée avec succès.
E_OUTOFMEMORY
 Échec de l’allocation de la chaîne className .
E_ILLEGAL_METHOD_CALL
 className fait référence à une fabrique de classes ou à une interface statique.

Notes

Utilisez la méthode GetRuntimeClassName pour récupérer le nom qualifié d’espace de noms d’un objet Windows Runtime.

L’appelant est chargé de libérer la chaîne className à l’aide de la fonction WindowsDeleteString .

Le tableau suivant montre des exemples de chaînes de nom de classe qui peuvent être retournées par la méthode GetRuntimeClassName .

Exemple de nom de classe Description
Fabrikam.Kitchen.IToaster Interface dans l’espace de noms Fabrikam.Kitchen.
Fabrikam.Kitchen.Chef Classe dans l’espace de noms Fabrikam.Kitchen.
Windows.Foundation.Collections.IVector'1<TailspinToys.IStore> Vecteur des interfaces TailspinToys.IStore.
Chaîne Windows.Foundation.Collections.IVector'1<Windows.Foundation.Collections.IMap'2<, TailspinToys.IStore>> Vecteur de mappages de chaînes aux interfaces TailspinToys.IStore.
 

La méthode GetRuntimeClassName fournit les informations de type les plus spécifiques que l’objet serveur garantit qu’il implémente. Le nom de type peut être un nom de classe runtime, un nom de groupe d’interface, un nom d’interface ou un nom d’interface paramétrable.

La méthode GetRuntimeClassName retourne E_ILLEGAL_METHOD_CALL si le nom de classe fait référence à une fabrique de classes ou à une interface statique.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête inspectable.h

Voir aussi

IInputPaneInterop

IInspectable

winrt ::get_class_name