Funzione SHParseDisplayName (shlobj_core.h)

Articolo
06/21/2023

Converte il nome visualizzato di un oggetto dello spazio dei nomi shell in un elenco di identificatori di elemento e restituisce gli attributi dell'oggetto. Questa funzione è il metodo preferito per convertire una stringa in un puntatore a un elenco di identificatori di elemento (PIDL).

Sintassi

SHSTDAPI SHParseDisplayName(
  [in]            PCWSTR           pszName,
  [in, optional]  IBindCtx         *pbc,
  [out]           PIDLIST_ABSOLUTE *ppidl,
  [in]            SFGAOF           sfgaoIn,
  [out, optional] SFGAOF           *psfgaoOut
);

Parametri

[in] pszName

Tipo: LPCWSTR

Puntatore a una stringa wide con terminazione zero contenente il nome visualizzato da analizzare.

[in, optional] pbc

Tipo: IBindCtx*

Contesto di associazione che controlla l'operazione di analisi. Questo parametro è in genere impostato su NULL.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Indirizzo di un puntatore a una variabile di tipo ITEMIDLIST che riceve l'elenco di identificatori di elemento per l'oggetto. Se si verifica un errore, questo parametro viene impostato su NULL.

[in] sfgaoIn

Tipo: SFGAOF

Valore ULONG che specifica gli attributi da eseguire per la query. Per eseguire una query per uno o più attributi, inizializzare questo parametro con i flag che rappresentano gli attributi di interesse. Per un elenco dei flag SFGAO disponibili, vedere SFGAO.

[out, optional] psfgaoOut

Tipo: SFGAOF*

Puntatore a una ULONG. In caso contrario, vengono impostati gli attributi true per l'oggetto e richiesti in sfgaoIn . I flag di attributo di un oggetto possono essere zero o una combinazione di flag SFGAO. Per un elenco dei flag SFGAO disponibili, vedere SFGAO.

Valore restituito

Tipo: HRESULT

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

Commenti

È consigliabile chiamare questa funzione da un thread in background. In caso contrario, l'interfaccia utente smette di rispondere.

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 6.0 o successiva)

Vedi anche

Ibindctx

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

ITEMIDLIST

SHGetPathFromIDList

Condividi tramite