Condividi tramite


Funzione SHCreateItemFromRelativeName (shobjidl_core.h)

Crea e inizializza un oggetto elemento shell da un nome di analisi relativo.

Sintassi

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

Parametri

[in] psiParent

Tipo: IShellItem*

Puntatore all'elemento Shell padre.

[in] pszName

Tipo: PCWSTR

Puntatore a una stringa Unicode con terminazione Null che specifica un nome visualizzato relativo allo psiParent.

[in] pbc

Tipo: IBindCtx*

Puntatore a un contesto di associazione che controlla l'operazione di analisi. Questo parametro può essere NULL.

[in] riid

Tipo: REFIID

Riferimento a un ID interfaccia.

[out] ppv

Tipo: void**

Quando questa funzione restituisce, contiene il puntatore dell'interfaccia richiesto in riid. In genere si tratta di IShellItem o IShellItem2.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll
Set di API ext-ms-win-shell32-l1-2-2 (introdotta in Windows 10 versione 10.0.14393)