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

  • Artigo

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

Redesenha o item especificado.

Sintaxe

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

Parâmetros

[in] pidl

Tipo: PUITEMID_CHILD

O item a ser redesenhado.

[out] puItem

Tipo: UINT*

Um ponteiro para um valor que, quando esse método retorna com êxito, recebe o índice do item que foi redesenhado. Você pode usar esse valor para chamar IShellFolderView::GetObject para recuperar o PITEMID_CHILD que você acabou de retirar.

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, receberá uma cópia do ITEMID_CHILD que você retirou. 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.

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