IShellFolderView::UpdateObject メソッド (shlobj_core.h)

[UpdateObject は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

ビュー内の項目を別の項目に置き換えます。

構文

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

パラメーター

[in] pidlOld

種類: PUITEMID_CHILD

元のアイテム。

[in] pidlNew

種類: PUITEMID_CHILD

新しい項目。

[out] puItem

種類: UINT*

このメソッドが戻るとき、 には、置き換えられた項目のインデックスへのポインターが含まれます。 この値を使用すると、後で IShellFolderView::GetObject を呼び出して、追加したPITEMID_CHILDを取り戻すことができます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

puItem によって返されたインデックスを使用して IShellFolderView::GetObject をすぐに呼び出すと、追加したITEMID_CHILDのコピーが取得されます。 ただし、アイテムのインデックス位置は時間の経過と同時に変化する可能性があるため、コードでは、特定のインデックスが常に同じITEMID_CHILDを返すという信頼はできません。

このメソッドを使用して行われた変更は、いつでもデータ ソースによってビューで破棄できます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h