SWbemObject.Subclasses_ méthode

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.

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

Voir aussi

SWbemObject

SWbemObjectSet