IWbemServices::QueryObjectSink, méthode (wbemcli.h)

Article
08/27/2023

La méthode IWbemServices::QueryObjectSink permet à l’appelant d’obtenir un gestionnaire de notification exporté par Windows Management. Cela permet à l’appelant d’écrire des notifications et des événements directement dans Windows Management. L’appelant doit écrire uniquement des événements extrinsèques dans Windows Management. Pour plus d’informations, consultez Détermination du type d’événement à recevoir.

Syntaxe

HRESULT QueryObjectSink(
  [in]  long            lFlags,
  [out] IWbemObjectSink **ppResponseHandler
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être 0.

[out] ppResponseHandler

Reçoit le pointeur d’interface vers le gestionnaire de notifications. Cette valeur est définie pour pointer sur NULL en cas d’erreur. Le pointeur retourné a un nombre de références positif, et l’appelant doit appeler IWbemServices::Release sur le pointeur lorsqu’il n’est plus nécessaire. Une valeur NULL peut être retournée si aucun gestionnaire de notification n’est disponible. Il ne s'agit pas d'une erreur.

Note La valeur du paramètre ppResponseHandler ne peut pas être NULL lorsqu’il est passé à cette méthode.

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.

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.

Note Le déclenchement d’événements à l’aide de QueryObjectSink est autorisé par défaut uniquement pour les administrateurs. L’extension de l’autorisation à d’autres utilisateurs nécessite de leur accorder WBEM_FULL_WRITE autorisation.

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

Voir aussi

IWbemObjectSink

IWbemServices

Interrogation de WMI

Partager via