Méthode IWbemServices::GetObject (wbemcli.h)
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 |