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

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

Substitui um item em um modo de exibição por outro item.

Sintaxe

HRESULT UpdateObject(
  [in]  PUITEMID_CHILD pidlOld,
  [in]  PUITEMID_CHILD pidlNew,
  [out] UINT           *puItem
);

Parâmetros

[in] pidlOld

Tipo: PUITEMID_CHILD

O item original.

[in] pidlNew

Tipo: PUITEMID_CHILD

O novo item.

[out] puItem

Tipo: UINT*

Quando esse método retorna, contém um ponteiro para o índice do item que foi substituído. Você pode usar esse valor para chamar IShellFolderView::GetObject posteriormente para retornar o PITEMID_CHILD que acabou de adicionar.

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

Se você chamar IShellFolderView::GetObject imediatamente com o índice retornado por puItem, obterá uma cópia do ITEMID_CHILD que você adicionou. No entanto, a posição do índice de um item pode ser alterada ao longo do tempo, portanto, o código não pode confiar que nenhum índice específico sempre retorna o mesmo ITEMID_CHILD.

As alterações feitas por meio desse método podem ser descartadas na exibição pela fonte de dados a qualquer momento.

Requisitos