Funzione StrRetToStrW (shlwapi.h)

Articolo
11/20/2024

Accetta una struttura STRRET restituita da IShellFolder::GetDisplayNameOf e restituisce un puntatore a una stringa allocata contenente il nome visualizzato.

Sintassi

LWSTDAPI StrRetToStrW(
  [in, out]      STRRET          *pstr,
  [in, optional] PCUITEMID_CHILD pidl,
  [out]          LPWSTR          *ppsz
);

Parametri

[in, out] pstr

Tipo: STRRET*

Puntatore alla struttura STRRET . Quando la funzione viene restituita, questo puntatore non sarà più valido.

[in, optional] pidl

Tipo: PCUITEMID_CHILD

Puntatore alla struttura ITEMIDLIST dell'elemento. Questo valore può essere NULL.

[out] ppsz

Tipo: LPTSTR*

Puntatore a una stringa allocata contenente il risultato. StrRetToStr alloca memoria per questa stringa con CoTaskMemAlloc. È consigliabile liberare la stringa con CoTaskMemFree quando non è più necessaria.

Valore restituito

Tipo: HRESULT

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

Osservazioni

Nota

L'intestazione shlwapi.h definisce StrRetToStr 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 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Vedere anche

StrRetToBuf

Condividi tramite