Função SHCreateItemFromRelativeName (shobjidl_core.h)

Cria e inicializa um objeto de item shell de um nome de análise relativo.

Sintaxe

SHSTDAPI SHCreateItemFromRelativeName(
  [in]  IShellItem *psiParent,
  [in]  PCWSTR     pszName,
  [in]  IBindCtx   *pbc,
  [in]  REFIID     riid,
  [out] void       **ppv
);

Parâmetros

[in] psiParent

Tipo: IShellItem*

Um ponteiro para o item shell pai.

[in] pszName

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica um nome de exibição relativo ao psiParent.

[in] pbc

Tipo: IBindCtx*

Um ponteiro para um contexto de associação que controla a operação de análise. Esse parâmetro pode ser NULL.

[in] riid

Tipo: REFIID

Uma referência a uma ID de interface.

[out] ppv

Tipo: void**

Quando essa função é retornada, contém o ponteiro de interface solicitado no riid. Isso geralmente 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