Metodo IWSManSession::Create (wsmandisp.h)
Crea una nuova istanza di una risorsa e restituisce il riferimento all'endpoint (EPR) del nuovo oggetto.
Sintassi
HRESULT Create(
[in] VARIANT resourceUri,
[in] BSTR resource,
[in] long flags,
[out] BSTR *newUri
);
Parametri
[in] resourceUri
Identificatore della risorsa da creare.
Questo parametro può contenere uno dei seguenti elementi:
- URI con uno o più selettore. Tenere presente che il plug-in WMI non supporta la creazione di alcuna risorsa diversa da un listener del protocollo WS-Management.
- Oggetto ResourceLocator che può contenere selettori, frammenti o opzioni.
- Riferimento all'endpoint di indirizzamento WS, come descritto nello standard del protocollo WS-Management. Per altre informazioni sulla specifica pubblica per il protocollo WS-Management, vedere Pagina indice specifiche di gestione.
[in] resource
Stringa XML contenente il contenuto della risorsa.
[in] flags
Riservato. Deve essere 0.
[out] newUri
Richiesta di reimpostazione della nuova risorsa.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
IWSManSession::Create viene usato solo per la creazione di nuove istanze di una risorsa. Usare il metodo IWSManSession::P ut per aggiornare le istanze esistenti di una risorsa. Dopo aver ottenuto il nuovo URI della risorsa, è possibile chiamare IWSManSession::Get per recuperare il nuovo oggetto. Il nuovo oggetto contiene le proprietà assegnate dal provider di risorse durante la creazione del nuovo oggetto. Ad esempio, se si crea un nuovo listener del protocollo WS-Management e si recupera l'oggettolistener usando Session.Get, si ottengono anche le proprietà Port, Enabled e ListenOn .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | wsmandisp.h |
| Libreria | WSManDisp.tlb |
| DLL | WSMAuto.dll |