Méthode IUnsecuredApartment ::CreateObjectStub (wbemcli.h)

Article
03/03/2024

La méthode CreateObjectStub crée un récepteur de redirecteur d’objets pour faciliter la réception d’appels asynchrones à partir de Windows Management. Cette fonction lie un récepteur d’objets non sécurisé à un récepteur d’objets local afin que la sécurité COM n’interfère pas avec la récupération asynchrone des objets CIM. Étant donné que la sécurité COM est contournée, le serveur d’administration Windows distant est supposé être un composant approuvé.

Le paradigme général est que l’implémentation d’origine d’IWbemObjectSink dans le processus client n’est pas directement utilisée dans les appels asynchrones à IWbemServices. Au lieu de cela, l’implémentation d’origine et un objet de substitution sont créés, liés ensemble, puis l’objet de substitution est utilisé dans les méthodes asynchrones d’IWbemServices.

Syntaxe

HRESULT CreateObjectStub(
  [in]  IUnknown *pObject,
  [out] IUnknown **ppStub
);

Paramètres

[in] pObject

Pointeur vers l’implémentation in-process du client d’IWbemObjectSink.

[out] ppStub

Reçoit un pointeur vers un objet de remplacement à utiliser dans les appels IWbemServices asynchrones. L’utilisateur reçoit un pointeur IUnknown et doit appeler QueryInterface pour IID_WbemObjectSink avant d’utiliser cet objet dans les appels IWbemServices asynchrones.

Valeur retournée

Cette méthode retourne des codes d’erreur COM standard pour QueryInterface. Il retourne S_OK si l’appel réussit. Si l’appel échoue parce que l’interface demandée n’était pas prise en charge, la méthode retourne E_NOINTERFACE.

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.

Remarques

Note Étant donné que le rappel au récepteur peut ne pas être retourné au même niveau d’authentification que celui requis par le client, il est recommandé d’utiliser semi-synchrone au lieu d’une communication asynchrone. Pour plus d’informations, consultez Appel d’une méthode.

Exemples

Pour obtenir un exemple complet qui montre comment utiliser l’interface IUnsecuredApartment , consultez Exemple : Réception de notifications d’événements via WMI.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	wbemcli.h (inclure Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Unsecapp.exe