SWbemServices.GetAsync, méthode

Article
07/03/2023

La méthode GetAsync de l’objet SWbemServices récupère un objet, qui est une définition de classe ou une instance, en fonction du chemin de l’objet.

Cette méthode récupère uniquement les objets de l’espace de noms associé à l’objet SWbemServices actuel.

Cette méthode est appelée en mode asynchrone. Pour plus d’informations, consultez Appel d’une méthode.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

SWbemServices.GetAsync( _
  ByVal objWbemSink, _
  [ ByVal strObjectPath ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Paramètres

objWbemSink: Obligatoire. Récepteur d’objets qui obtient des objets de manière asynchrone. Créez un objet SWbemSink où recevoir les objets.
strObjectPath [facultatif]: Chemin de l’objet que vous souhaitez récupérer. Si cette valeur est vide, l’objet vide retourné peut devenir une nouvelle classe. Pour plus d’informations, consultez Description de l’emplacement d’un objet WMI.
iFlags [facultatif]: Entier qui détermine le comportement de l’appel. Ce paramètre peut accepter les valeurs suivantes.
wbemFlagSendStatus (128 (0x80)): Provoque des appels asynchrones pour envoyer des mises à jour de l’état du récepteur d’objets au gestionnaire d’événements OnProgress.
wbemFlagDontSendStatus (0 (0x0)): Empêche les appels asynchrones d’envoyer des mises à jour de l’état du récepteur d’objets au gestionnaire d’événements OnProgress.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Permet à WMI de retourner des données de modification de classe avec la définition de classe de base. Pour plus d’informations, consultez Localisation des informations de classe WMI.

objwbemNamedValueSet [facultatif]

En règle générale, cette valeur n’est pas définie. Autrement, 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 requête. 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.

objWbemAsyncContext [facultatif]

Objet SWbemNamedValueSet qui est retourné au récepteur d’objets pour identifier la source de l’appel asynchrone d’origine. Utilisez ce paramètre si vous effectuez plusieurs appels asynchrones à l’aide du même récepteur d’objets. Pour utiliser ce paramètre, créez un objet SWbemNamedValueSet et utilisez la méthode SWbemNamedValueSet.Add pour ajouter une valeur qui identifie l’appel asynchrone que vous effectuez. Cet objet SWbemNamedValueSet est retourné au récepteur de l’objet, et la source de l’appel peut être extraite à l’aide de la méthode SWbemNamedValueSet.Item. Pour plus d’informations, consultez Appel d’une méthode.

Valeur retournée

Cette méthode ne retourne pas de valeur. En cas de réussite, le récepteur reçoit un événement OnObjectReady lorsque l’objet est disponible.

Codes d’erreur

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

wbemErrAccessDenied - 2147749891 (0x80041003): L’utilisateur actuel n’est pas autorisé à accéder à l’objet.
wbemErrFailed - 2147749889 (0x80041001): Erreur non spécifiée.
wbemErrInvalidParameter - 2147749896 (0x80041008): Un paramètre spécifié n’est pas valide.
wbemErrInvalidObjectPath - 2147749946 (0x8004103A): Le chemin spécifié n’est pas valide.
wbemErrNotFound - 2147749890 (0x80041002): L’objet demandé est introuvable.
wbemErrOutOfMemory - 2147749894 (0x80041006): La mémoire disponible est insuffisante pour terminer cette opération.

Notes

Cet appel est retourné immédiatement. L’objet et l’état demandés sont retournés à l’appelant par le biais d’un rappel remis au récepteur spécifié dans objWbemSink. Pour traiter l’objet lorsqu’il retourne, créez une sous-routine d’événement objWbemSink.OnObjectReady ou objWbemSink.OnCompleted.

Un rappel asynchrone permet à un utilisateur non authentifié de fournir des données au récepteur. Cela pose des risques de sécurité pour vos scripts et applications. Pour éliminer les risques, utilisez la communication semi-synchrone ou synchrone. Pour plus d’informations, consultez Définition de la sécurité sur un appel asynchrone.

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_SWbemServices
IID	IID_ISWbemServices

Voir aussi

SWbemServices
SWbemObject

Partager via