funzione MI_Session_ModifyInstance (mi.h)

Aggiornamenti un'istanza esistente nel server rappresentato dalla sessione.

Sintassi

MI_INLINE void MI_Session_ModifyInstance(
  [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 sessione restituito da MI_Application_NewSession.

flags

Flag di tipo di runtime (RTTI). Può essere impostato su 0.

[in, optional] options

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

namespaceName

Stringa facoltativa con terminazione null che rappresenta il nome dello spazio dei nomi per eseguire l'operazione. Se non è specificato alcun elemento, il server selezionerà un valore predefinito. Lo spazio dei nomi non può includere un nome computer. Può essere solo sotto forma di un nome dello spazio dei nomi separato da un carattere di contrassegno barra (/). Ad esempio, il valore seguente è un valore dello spazio dei nomi valido: root/cimv2.

[in] inboundInstance

MI_Instance che rappresenta il nome della classe e la chiave dell'istanza da modificare nel server.

[in, optional] callbacks

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

[out] operation

Handle dell'operazione restituito che deve essere chiuso tramite MI_Operation_Close una volta completato. La chiamata MI_Operation_Cancel prima del completamento dell'operazione causerà l'arresto dell'operazione. MI_Operation_Close e MI_Operation_Cancel possono essere chiamati da qualsiasi operazione.

Valore restituito

nessuno

Osservazioni

La funzione avrà esito negativo se l'istanza non esiste.

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_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance