Partilhar 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 do psfParent. Esse parâmetro pode 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 relativa à pasta pai especificada por psfParent ou pidlParent.

[in] riid

Tipo: REFIID

Uma referência a uma ID de interface.

[out] ppvItem

Tipo: void**

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

Valor de retorno

Tipo: HRESULT

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

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header shobjidl_core.h (inclua Shobjidl.h)
Library OneCore.Lib
de DLL Shell32.dll