Condividi tramite

Funzione SHILCreateFromPath (shlobj_core.h)

  • Articolo

[SHILCreateFromPath è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Le applicazioni devono invece usare SHParseDisplayName ]

Crea un puntatore a un elenco di identificatori di elemento (PIDL) da un percorso.

Sintassi

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Parametri

[in] pszPath

Tipo: PCWSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH contenente il percorso da convertire.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Percorso in pszPath espresso come PIDL.

[in, out, optional] rgfInOut

Tipo: DWORD*

Puntatore a un valore DWORD che, nella voce, indica tutti gli attributi della cartella denominata in pszPath che l'applicazione chiamante desidera recuperare insieme al PIDL. All'uscita, questo valore contiene gli attributi richiesti. Per un elenco dei possibili flag di attributo per questo parametro, vedere IShellFolder::GetAttributesOf.

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 XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (includere Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-1 (introdotto in Windows 10, versione 10.0.10240)