IWSManSession ::Create, méthode (wsmandisp.h)

Article
03/13/2024

Crée une instance d’une ressource et retourne la référence de point de terminaison (EPR) du nouvel objet.

Syntaxe

HRESULT Create(
  [in]  VARIANT resourceUri,
  [in]  BSTR    resource,
  [in]  long    flags,
  [out] BSTR    *newUri
);

Paramètres

[in] resourceUri

Identificateur de la ressource à créer.

Ce paramètre peut contenir l’un des éléments suivants :

URI avec un ou plusieurs sélecteurs. N’oubliez pas que le plug-in WMI ne prend pas en charge la création d’une ressource autre qu’un écouteur de protocole WS-Management.
Objet ResourceLocator qui peut contenir des sélecteurs, des fragments ou des options.
Référence du point de terminaison WS-Addressing , comme décrit dans la norme de protocole WS-Management. Pour plus d’informations sur la spécification publique du protocole WS-Management, consultez Page d’index des spécifications de gestion.

[in] resource

Chaîne XML qui contient du contenu de ressource.

[in] flags

Réservé. Doit avoir la valeur 0.

[out] newUri

EPR de la nouvelle ressource.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

IWSManSession ::Create est utilisé uniquement pour créer des instances d’une ressource. Utilisez la méthode IWSManSession ::P ut pour mettre à jour les instances existantes d’une ressource. Une fois que vous avez obtenu le nouvel URI de ressource, vous pouvez appeler IWSManSession ::Get pour récupérer le nouvel objet. Le nouvel objet contient toutes les propriétés que le fournisseur de ressources affecte lors de la création de l’objet . Par exemple, si vous créez unécouteur de protocole WS-Management et récupérez l’objet de l’écouteur à l’aide de Session.Get, vous obtenez également les propriétés Port, Enabled et ListeningOn .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wsmandisp.h
Bibliothèque	WSManDisp.tlb
DLL	WSMAuto.dll

Voir aussi

IWSManSession

Session.Create