Compartir a través de

Función SHCreateItemFromRelativeName (shobjidl_core.h)

  • Artículo

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

Sintaxis

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 realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shell32.dll
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)