funzione MI_Instance_SetElement (mi.h)

Articolo
03/05/2024

Impostare il valore dell'elemento con il nome specificato nell'istanza specificata.

Sintassi

MI_INLINE MI_Result MI_INLINE_CALL MI_Instance_SetElement(
  [out]          MI_Instance    *self,
                 const MI_Char  *name,
  [in, optional] const MI_Value *value,
                 MI_Type        type,
                 MI_Uint32      flags
);

Parametri

[out] self

Puntatore a un'istanza.

name

Stringa con terminazione null che rappresenta il nome dell'elemento che verrà impostato.

[in, optional] value

Nuovo valore per l'elemento.

type

Tipo CIM dell'elemento che verrà impostato.

flags

Flag di bit che indicano criteri di gestione della memoria.

MI_FLAG_BORROW

Usato durante l'aggiunta e l'impostazione delle proprietà in un MI_Instance per indicare che l'istanza non copia il valore. Il valore deve rimanere valido finché l'istanza non viene eliminata.

MI_FLAG_ADOPT

Usato durante l'aggiunta e l'impostazione delle proprietà in un MI_Instance per indicare che l'istanza adotta il puntatore e sarà responsabile dell'eliminazione.

MI_FLAG_NULL

Il valore dell'elemento è Null.

Valore restituito

Questa funzione restituisce MI_INLINE MI_Result MI_INLINE_CALL.

Commenti

Per impostazione predefinita, viene copiata tutta la memoria a cui fa riferimento il parametro value. Passando il flag MI_FLAG_BORROW, i puntatori di memoria all'interno della struttura del valore vengono archiviati direttamente nell'elemento dell'istanza. Il chiamante deve garantire che la memoria sia in uscita dall'istanza.

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

Condividi tramite