SWbemObject.Subclasses_ méthode

Article
06/29/2023

La méthodeSubclasses_ de l’objet SWbemObject renvoie un objet SWbemObjectSet. Cet objet est une collection de sous-classes de l’objet actuel, qui doit être une classe . Les éléments de la collection retournée peuvent être obtenus à l’aide de méthodes de collection standard. Pour plus d’informations, consultez Accéder à une collection.

Pour plus d’explications sur cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

objWbemObjectSet = .Subclasses_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Paramètres

iFlags [entrée, facultatif]: Entier qui détermine le détail de l’énumération de l’appel. Ce paramètre peut accepter les valeurs suivantes.
wbemQueryFlagDeep (0 (0x0)): Force l’énumération récursive dans toutes les sous-classes dérivées de la classe parente spécifiée. La classe parente elle-même n’est pas retournée dans l’énumération.
wbemQueryFlagShallow (1 (0x1)): Valeur par défaut pour ce paramètre. Elle force l’énumération à inclure uniquement les sous-classes immédiates de la classe parente spécifiée.
WbemFlagReturnImmediately (16 (0x10)): Provoque le retour immédiat de l’appel
wbemFlagReturnWhenComplete (0 (0x0)): Provoque le blocage de cet appel jusqu’à ce que l’appel soit terminé.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Amène WMI à retourner les données de modification de classe avec la définition de classe de base.

objwbemNamedValueSet [in, optional]

En règle générale, ceci n’est pas défini. Sinon, il s’agit d’un objet SWbemNamedValueSet dont les éléments représentent les informations de contexte qui peuvent être utilisées par le fournisseur répondant à la demande. Un fournisseur qui prend en charge ou requiert de telles informations doit documenter les noms de valeur reconnus, le type de données de la valeur, les valeurs autorisées et la sémantique.

Valeur retournée

Si l’appel réussit, un objet SWbemObjectSet est retourné.

Codes d’erreur

Une fois la méthode Subclasses_ terminée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

wbemErrAccessDenied - 2147749891 (0x80041003): L’utilisateur actuel n’a pas l’autorisation d’afficher une ou plusieurs des classes retournées par l’appel.
wbemErrFailed - 2147749889 (0x80041001): Erreur non spécifiée.
wbemErrInvalidClass - 2147749904 (0x80041010): La classe spécifiée n’existait pas.
wbemErrInvalidParameter - 2147749896 (0x80041008): Un paramètre non valide a été spécifié.
wbemErrOutOfMemory - 2147749894 (0x80041006): La mémoire disponible est insuffisante pour terminer cette opération.

Notes

Il ne s’agit pas d’une erreur pour que la collection retournée ait zéro élément s’il n’y a pas de sous-classes de l’objet actuel. La méthode Subclasses_ fonctionne uniquement pour les objets de classe.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Voir aussi

SWbemObject
SWbemObjectSet