Compartilhar via

Função SHCreateItemFromRelativeName (shobjidl_core.h)

  • Artigo

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 do 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. Este parâmetro pode ser NULL.

[in] riid

Tipo: REFIID

Uma referência para uma ID de interface.

[out] ppv

Tipo: void**

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

Retornar valor

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

Requisito Valor
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
Conjunto de APIs ext-ms-win-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)