Método SWbemPropertySet.Remove
O método Remove do objeto SWbemPropertySet exclui uma propriedade da coleção SWbemPropertySet.
Para conferir uma explicação dessa sintaxe, consulte Convenções de documentação para API de script.
Sintaxe
SWbemPropertySet.Remove( _
ByVal strName, _
[ ByVal iFlags ] _
)
Parâmetros
-
strName [in]
-
Obrigatórios. Nome do item a ser removido.
-
iFlags [in, opcional]
-
Reservado. Esse valor deve ser 0 (zero) se especificado.
Retornar valor
Esse método não retorna um valor.
Códigos do Erro
Após a conclusão do método Remove, o objeto Err pode conter um dos códigos de erro da lista a seguir.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Falha não especificada.
-
wbemErrInvalidOperation - 2147749910 (0x80041016)
-
O usuário tentou excluir uma propriedade que não pode ser excluída.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Foi especificado um parâmetro inválido.
-
wbemErrNotFound - 2147749890 (0x80041002)
-
A propriedade especificada não existe.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memória insuficiente para executar esse método.
-
wbemErrPropagatedProperty - 142927303552 (0x2147219380)
-
O usuário tentou excluir uma propriedade sem proprietário. A propriedade foi herdada de uma classe pai.
-
wbemErrResetToDefault - 2147758082 (0x80043002)
-
O usuário excluiu um valor padrão de substituição para a classe atual. O valor padrão dessa propriedade na classe pai foi reativado.
Comentários
As propriedades não podem ser removidas de instâncias de classe ou de classes derivadas com propriedades herdadas. Essas tentativas de exclusão geram um erro e a propriedade não é removida; a propriedade é redefinida para seu valor padrão.
Não é possível iterar uma coleção ao remover itens porque, quando você remove um elemento de uma coleção, o ponteiro da coleção é movido para o próximo elemento. Para obter mais informações, consulte Acessar uma coleção.
Exemplos
Para obter um exemplo de código que use esse método, confira o tópico SWbemPropertySet.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemPropertySet |
| IID |
IID_ISWbemPropertySet |