Metodo IShellFolderView::AddObject (shlobj_core.h)

[AddObject è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Aggiunge un elemento alla visualizzazione.

Sintassi

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

Parametri

[in] pidl

Tipo: PUITEMID_CHILD

Puntatore a un ItemID che specifica l'elemento da aggiungere alla visualizzazione.

[out] puItem

Tipo: UINT*

Puntatore a un valore che, quando questo metodo restituisce correttamente, riceve la posizione di indice dell'elemento 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 si chiama immediatamente IShellFolderView::GetObject con questo indice, si otterrà una copia del ITEMID_CHILD aggiunto. Tuttavia, la posizione di indice di un elemento può cambiare nel tempo, in modo che il codice non possa considerare attendibile che qualsiasi indice specifico restituisce sempre la stessa ITEMID_CHILD.

Gli elementi aggiunti tramite questo metodo possono essere rimossi dalla visualizzazione dall'origine dati in qualsiasi momento.

Requisiti