Edit

IUpdateIDList::Update method (shobjidl_core.h)

  • Article

Updates the provided child ITEMIDLIST based on the parameters specified by the provided IBindCtx.

Syntax

HRESULT Update(
  [in, optional] IBindCtx        *pbc,
  [in]           PCUITEMID_CHILD pidlIn,
  [out]          PITEMID_CHILD   *ppidlOut
);

Parameters

[in, optional] pbc

Type: IBindCtx*

An IBindCtx interface on a bind context object. Used to specify parameters for updating the child ITEMIDLIST. This value can be NULL.

[in] pidlIn

Type: PCUITEMID_CHILD

The child ITEMIDLIST.

[out] ppidlOut

Type: PITEMID_CHILD*

A pointer to the child ITEMIDLIST relative to the parent folder.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If pbc is NULL or does not contain any parameters that apply to the current Shell folder, ppidlOut points to the same ITEMIDLIST as pidlIn.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

ITEMIDLIST

IUpdateIDList