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	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPropertySet
IID	IID_ISWbemPropertySet

Confira também

SWbemPropertySet

SWbemPropertySet.Add