Funzione SHGetNameFromIDList (shobjidl_core.h)

Articolo
03/02/2024

Recupera il nome visualizzato di un elemento identificato dal relativo IDList.

Sintassi

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

Parametri

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

PiDL che identifica l'elemento.

[in] sigdnName

Tipo: SIGDN

Valore dell'enumerazione SIGDN che specifica il tipo di nome visualizzato da recuperare.

[out] ppszName

Tipo: PWSTR*

Valore che, quando questa funzione restituisce correttamente, riceve l'indirizzo di un puntatore al nome visualizzato recuperato.

Valore restituito

Tipo: HRESULT

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

Commenti

È responsabilità del chiamante liberare la stringa puntata da ppszName quando non è più necessaria. Chiamare CoTaskMemFree in *ppszName per liberare la memoria.

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

Condividi tramite