Metodo SWbemPropertySet.Remove

Articolo
06/13/2023

Il metodo Remove dell'oggetto SWbemPropertySet elimina una proprietà dall'insieme SWbemPropertySet .

Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.

Sintassi

SWbemPropertySet.Remove( _
  ByVal strName, _
  [ ByVal iFlags ] _
)

Parametri

strName [in]: Obbligatorio. Nome dell'elemento da rimuovere.
iFlags [in, facoltativo]: Riservato. Se specificato, questo valore deve essere 0 (zero).

Valore restituito

Questo metodo non restituisce valori.

Codici di errore

Dopo il completamento del metodo Remove , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.

wbemErrFailed - 2147749889 (0x80041001): Errore non specificato.
wbemErrInvalidOperation - 2147749910 (0x80041016): L'utente ha tentato di eliminare una proprietà che non può essere eliminata.
wbemErrInvalidParameter - 2147749896 (0x80041008): È stato specificato un parametro non valido.
wbemErrNotFound - 2147749890 (0x80041002): La proprietà specificata non esiste.
wbemErrOutOfMemory - 2147749894 (0x80041006): Memoria insufficiente per l'esecuzione di questo metodo.
wbemErrPropagatedProperty - 142927303552 (0x2147219380): L'utente ha tentato di eliminare una proprietà non di proprietà. La proprietà è stata ereditata da una classe padre.
wbemErrResetToDefault - 2147758082 (0x80043002): L'utente ha eliminato un valore predefinito di override per la classe corrente. Il valore predefinito per questa proprietà nella classe padre è stato riattivato.

Commenti

Le proprietà non possono essere rimosse da istanze di classe o classi derivate con proprietà ereditate. Tali tentativi di eliminazione generano un errore e la proprietà non viene rimossa; la proprietà viene reimpostata sul valore predefinito.

Non è possibile eseguire l'iterazione di una raccolta durante la rimozione di elementi perché quando si rimuove un elemento da una raccolta, il puntatore alla raccolta viene spostato nell'elemento successivo. Per altre informazioni, vedere Accesso a una raccolta.

Esempio

Per un esempio di codice che usa questo metodo, vedere l'argomento SWbemPropertySet .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Wbemdisp.h
Libreria dei tipi	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPropertySet
IID	IID_ISWbemPropertySet

Vedi anche

SWbemPropertySet
SWbemPropertySet.Add

Condividi tramite