Partager via

Fonction SHCreateItemFromRelativeName (shobjidl_core.h)

  • Article

Crée et initialise un objet d’élément Shell à partir d’un nom d’analyse relatif.

Syntaxe

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

Paramètres

[in] psiParent

Type : IShellItem*

Pointeur vers l’élément Shell parent.

[in] pszName

Type : PCWSTR

Pointeur vers une chaîne Unicode terminée par null qui spécifie un nom d’affichage relatif au psiParent.

[in] pbc

Type : IBindCtx*

Pointeur vers un contexte de liaison qui contrôle l’opération d’analyse. Ce paramètre peut être NULL.

[in] riid

Type : REFIID

Référence à un ID d’interface.

[out] ppv

Type : void**

Lorsque cette fonction retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IShellItem ou D’IShellItem2.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (inclure Shobjidl.h)
DLL Shell32.dll
Ensemble d’API ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)