Compartilhar via

Método IShellFolderView::RemoveObject (shlobj_core.h)

  • Artigo

[RemoveObject está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Remove um item do modo de exibição.

Sintaxe

HRESULT RemoveObject(
  [in, optional] PUITEMID_CHILD pidl,
  [out]          UINT           *puItem
);

Parâmetros

[in, optional] pidl

Tipo: PUITEMID_CHILD

Um ponteiro para o item a ser removido do modo de exibição. Esse valor pode ser NULL. Ao usar o objeto de exibição de pasta do sistema (DefView) em Windows XP e Windows Vista, um valor NULL resulta na remoção de todos os objetos da exibição.

[out] puItem

Tipo: UINT*

Quando esse método retorna, contém um ponteiro para a posição de índice do item removido.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os itens removidos por meio desse método podem ser adicionados novamente à exibição pela fonte de dados a qualquer momento.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h