Méthode IWbemServices::GetObject (wbemcli.h)

Article
08/27/2023

La méthode IWbemServices::GetObject récupère une classe ou un instance. Cette méthode récupère uniquement les objets de l’espace de noms associé à l’objet IWbemServices actuel.

Syntaxe

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

Paramètres

[in] strObjectPath

Chemin de l’objet à récupérer. Si cette valeur est NULL, un objet vide est retourné qui peut devenir une nouvelle classe. Pour plus d’informations, consultez Création d'un commentaire.

[in] lFlags

Les indicateurs suivants affectent le comportement de cette méthode.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

Si cet indicateur est défini, WMI récupère les qualificateurs modifiés stockés dans l’espace de noms localisé des paramètres régionaux de la connexion actuelle. S’il n’est pas défini, seuls les qualificateurs stockés dans l’espace de noms immédiat sont récupérés.

WBEM_FLAG_RETURN_WBEM_COMPLETE

Cet indicateur en fait un appel synchrone.

WBEM_FLAG_RETURN_IMMEDIATELY

Cet indicateur en fait un appel semi-synchrone. Vous devez fournir un pointeur valide pour le paramètre ppCallResult . Pour plus d’informations, consultez Appel d’une méthode.

WBEM_FLAG_DIRECT_READ

Cet indicateur entraîne un accès direct au fournisseur pour la classe spécifiée sans égard à sa ou ses sous-classes parentes.

[in] pCtx

Généralement NULL. Sinon, il s’agit d’un pointeur vers un objet IWbemContext qui peut être utilisé par le fournisseur qui produit la classe ou le instance demandé. Les valeurs de l’objet de contexte doivent être spécifiées dans la documentation du fournisseur en question. Pour plus d’informations sur ce paramètre, consultez Effectuer des appels à WMI.

[out] ppObject

Si ce n’est pas NULL, l’objet est reçu, s’il est trouvé. L’objet retourné a un nombre de références positif. L’appelant doit utiliser Release lorsque l’objet n’est plus nécessaire. Dans tous les cas d’erreur, ce paramètre est défini pour pointer sur NULL.

[out] ppCallResult

Si la valeur est NULL, ce paramètre n’est pas utilisé. Si le paramètre lFlags contient WBEM_FLAG_RETURN_IMMEDIATELY, cet appel retourne immédiatement avec WBEM_S_NO_ERROR. Le paramètre ppCallResult reçoit un pointeur vers un nouvel objet IWbemCallResult , qui peut ensuite être interrogé pour obtenir le résultat à l’aide de la méthode GetCallStatus . L’appelant peut appeler IWbemCallResult::GetResultObject pour récupérer l’objet lorsqu’il devient disponible.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

En cas d’échec, vous pouvez obtenir toutes les informations disponibles à partir de la fonction COM GetErrorInfo.

Des codes d’erreur spécifiques à COM peuvent également être retournés si des problèmes réseau vous font perdre la connexion à distance à Windows Management.

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (inclure Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll