Compartir a través de


Función SHCreateItemFromRelativeName (shobjidl_core.h)

Crea e inicializa un objeto de elemento de Shell a partir de un nombre de análisis relativo.

Syntax

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

Parámetros

[in] psiParent

Tipo: IShellItem*

Puntero al elemento shell primario.

[in] pszName

Tipo: PCWSTR

Puntero a una cadena Unicode terminada en null que especifica un nombre para mostrar relativo al psiParent.

[in] pbc

Tipo: IBindCtx*

Puntero a un contexto de enlace que controla la operación de análisis. Este parámetro puede ser null.

[in] riid

Tipo: REFIID

Referencia a un identificador de interfaz.

[out] ppv

Tipo: void**

Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Normalmente será IShellItem o IShellItem2.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header shobjidl_core.h (incluya Shobjidl.h)
Library OneCore.Lib
DLL Shell32.dll
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)