ILLoadFromStreamEx(IStream*, PITEMID_CHILD*) function

[ILLoadFromStreamEx(IStream*, PITEMID_CHILD*) is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Loads a child pointer to an item identifier list (PIDL) from an IStream.

Syntax

HRESULT ILLoadFromStreamEx(
  _In_  IStream       *pstm,
  _Out_ PITEMID_CHILD *ppidl
);

Parameters

• pstm [in]
  Type: IStream*

  A pointer to the IStream interface from which the child PIDL loads.

• ppidl [out]
  Type: PITEMID_CHILD*

  When this function returns and succeeds, contains a child PIDL, which contains exactly one SHITEMID structure. If it fails, contains NULL.

Return value

Type: HRESULT

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

Remarks

For use where STRICT_TYPED_ITEMIDS is defined.

Requirements