IWSManSession ::Create, méthode (wsmandisp.h)
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 desoptions.
- 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 |