Funzione StrRetToStrA (shlwapi.h)
Accetta una struttura STRRET restituita da IShellFolder::GetDisplayNameOf e restituisce un puntatore a una stringa allocata contenente il nome visualizzato.
Sintassi
LWSTDAPI StrRetToStrA(
[in, out] STRRET *pstr,
[in, optional] PCUITEMID_CHILD pidl,
[out] LPSTR *ppsz
);
Parametri
[in, out] pstr
Tipo: STRRET*
Puntatore alla struttura STRRET . Quando la funzione restituisce, 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 la 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 .
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| 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 | Windows |
| Intestazione | shlwapi.h |
| Libreria | Shlwapi.lib |
| DLL | Shlwapi.dll (versione 5.0 o successiva) |