Compartilhar via


Função SHCreateItemWithParent (shobjidl_core.h)

Crie um item shell, considerando uma pasta pai e uma ID de item filho.

Sintaxe

SHSTDAPI SHCreateItemWithParent(
  [in]  PCIDLIST_ABSOLUTE pidlParent,
  [in]  IShellFolder      *psfParent,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  REFIID            riid,
  [out] void              **ppvItem
);

Parâmetros

[in] pidlParent

Tipo: PCIDLIST_ABSOLUTE

A IDList da pasta pai do item que está sendo criado; a IDList de psfParent. Esse parâmetro poderá ser NULL, se psfParent for especificado.

[in] psfParent

Tipo: IShellFolder*

Um ponteiro para a interface IShellFolder que especifica a fonte de dados do shell do item filho especificado pelo pidl. Esse parâmetro poderá ser NULL, se pidlParent for especificado.

[in] pidl

Tipo: PCUITEMID_CHILD

Uma ID de item filho em relação à pasta pai especificada por psfParent ou pidlParent.

[in] riid

Tipo: REFIID

Uma referência para uma ID de interface.

[out] ppvItem

Tipo: void**

Quando essa função retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso será IShellItem ou IShellItem2.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll