Metodo IWSManSession::Create (wsmandisp.h)

Articolo
03/13/2024

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

Vedi anche

IWSManSession

Session.Create

Share via