Funzione SHGetPathFromIDListW (shlobj_core.h)

Articolo
11/20/2024

Converte un elenco di identificatori di elemento in un percorso del file system.

Sintassi

BOOL SHGetPathFromIDListW(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPWSTR            pszPath
);

Parametri

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

Indirizzo di un elenco di identificatori di elemento che specifica un file o un percorso di directory relativo alla radice dello spazio dei nomi (desktop).

[out] pszPath

Tipo: LPTSTR

Indirizzo di un buffer per ricevere il percorso del file system. Questo buffer deve avere dimensioni di almeno MAX_PATH caratteri.

Valore restituito

Tipo: bool

Restituisce TRUE in caso di esito positivo; in caso contrario, FALSE.

Osservazioni

Se il percorso specificato dal parametro pidl non fa parte del file system, questa funzione avrà esito negativo.

Se il parametro pidl specifica un collegamento, il pszPath conterrà il percorso del collegamento, non alla destinazione del collegamento.

Nota

L'intestazione shlobj_core.h definisce SHGetPathFromIDList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 4.0 o successiva)
set di API	ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393)

Vedere anche

SHGetPathFromIDListEx

SHParseDisplayName

Condividi tramite