funzione MI_Session_CreateInstance (mi.h)

Crea un'istanza del server rappresentata dalla sessione.

Sintassi

MI_INLINE void MI_Session_CreateInstance(
  [in]           MI_Session            *session,
                 MI_Uint32             flags,
  [in, optional] MI_OperationOptions   *options,
                 const MI_Char         *namespaceName,
  [in]           const MI_Instance     *inboundInstance,
  [in, optional] MI_OperationCallbacks *callbacks,
  [out]          MI_Operation          *operation
);

Parametri

[in] session

Handle di sessione restituito da MI_Application_NewSession.

flags

Flag RTTI (Runtime Type Information).

[in, optional] options

Valore facoltativo MI_OperationOptions che specifica opzioni quali timeout e come controllare la semantica CIM. Specificare Null se non devono essere inviate opzioni di operazione.

namespaceName

Stringa con terminazione Null contenente il nome dello spazio dei nomi facoltativo per eseguire l'operazione. Se non viene specificato alcun valore, il server selezionerà un valore predefinito. Lo spazio dei nomi non può includere un nome computer. Può essere solo sotto forma di nome dello spazio dei nomi separato da un carattere di barra (/). Ad esempio, di seguito è riportato un valore namespaceName valido: root/cimv2.

[in] inboundInstance

MI_Instance che rappresenta il nome della classe e le chiavi dell'istanza da creare nel server insieme al resto delle proprietà dell'istanza su cui verrà impostata l'istanza di destinazione. A volte le chiavi sono di sola lettura, quindi non è necessario specificare tutte le chiavi. Se l'istanza specificata esiste già, la funzione avrà esito negativo; per aggiornare un'istanza esistente, usare la funzione MI_Session_ModifyInstance .

[in, optional] callbacks

Struttura facoltativa MI_OperationCallbacks che definisce i callback operativi per ricevere il risultato dell'istanza e la semantica CIM. Per eseguire questa operazione in modo asincrono, è necessario specificare questo valore. Se viene specificato NULL, il client deve chiamare la funzione MI_Operation_GetInstance per recuperare i risultati.

[out] operation

Handle dell'operazione che deve essere chiuso con una chiamata a MI_Operation_Close al termine dell'operazione e tutti i risultati sono stati ricevuti. L'handle può essere utilizzato per annullare l'operazione con una chiamata a MI_Operation_Cancel.

Valore restituito

nessuno

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	mi.h
Componente ridistribuibile	Windows Management Framework 3.0 in Windows Server 2008 R2 con SP1, Windows 7 con SP1 e Windows Server 2008 con SP2

Vedi anche

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance

MI_Session_ModifyInstance