Metodo Provider::D eleteInstance(constCInstance&,long) (provider.h)

[La classe Provider fa parte di WMI Provider Framework, che viene ora considerata in stato finale e non saranno disponibili ulteriori sviluppi, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

Il metodo DeleteInstance viene chiamato da WMI per eliminare un'istanza di .

Sintassi

HRESULT DeleteInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Parametri

[ref] newInstance

Istanza da eliminare.

lFlags

Maschera di bit dei flag con informazioni sull'operazione di eliminazione. Questo è il valore specificato dal client nella funzione IWbemServices::D eleteInstance .

Il flag seguente viene gestito da (e filtrato) da WMI:

• WBEM_FLAG_RETURN_IMMEDIATELY

Valore restituito

L'implementazione predefinita del provider di framework di questo metodo restituisce WBEM_E_PROVIDER_NOT_CAPABLE alla funzione chiamante. La funzione IWbemServices::D eleteInstance elenca i valori restituiti più comuni, anche se è possibile scegliere di restituire qualsiasi codice restituito COM.

Commenti

WMI richiama DeleteInstance quando un client chiama IWbemServices::D eleteInstance su una classe. Pertanto, è necessario implementare DeleteInstance se il provider di framework supporta l'eliminazione di istanze. L'elenco seguente descrive un'implementazione comune di DeleteInstance:

1. Determinare l'istanza richiesta dal client leggendo le proprietà chiave con uno dei metodi Get per CInstance, ad esempio CInstance::GetCHString.
2. Eliminare l'istanza.

Requisiti