Metodo IShellFolderView::UpdateObject (shlobj_core.h)

[UpdateObject è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Sostituisce un elemento in una visualizzazione con un altro elemento.

Sintassi

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

Parametri

[in] pidlOld

Tipo: PUITEMID_CHILD

Elemento originale.

[in] pidlNew

Tipo: PUITEMID_CHILD

Nuovo elemento.

[out] puItem

Tipo: UINT*

Quando termina, questo metodo contiene un puntatore all'indice dell'elemento sostituito. È possibile usare questo valore per chiamare IShellFolderView::GetObject in un secondo momento per ottenere il PITEMID_CHILD appena aggiunto.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se chiami immediatamente IShellFolderView::GetObject con l'indice restituito da puItem, riceverai una copia del ITEMID_CHILD aggiunto. Tuttavia, la posizione di indice di un elemento può cambiare nel tempo, pertanto il codice non può considerare attendibile che qualsiasi indice specifico restituisca sempre lo stesso ITEMID_CHILD.

Le modifiche apportate tramite questo metodo possono essere eliminate nella visualizzazione dall'origine dati in qualsiasi momento.

Requisiti