Funzione StrRetToStrN
Accetta una struttura STRRET restituita da IShellFolder::GetDisplayNameOf, la converte in una stringa e inserisce il risultato in un buffer.
Sintassi
BOOL StrRetToStrN(
_Out_ LPTSTR pszOut,
_In_ UINT cchOut,
_Inout_ LPSTRRET pStrRet,
_In_ LPCITEMIDLIST pidl
);
Parametri
-
pszOut [out]
-
Tipo: LPTSTR
Buffer per contenere il nome visualizzato. Verrà restituito come stringa con terminazione Null. Se cchOut è troppo piccolo, il nome verrà troncato per adattarsi.
-
cchOut [in]
-
Tipo: UINT
Dimensioni di pszOut, in caratteri. Se cchOut è troppo piccolo, la stringa verrà troncata per adattarsi.
-
pStrRet [in, out]
-
Tipo: LPSTRRET
Puntatore a una struttura STRRET . Al termine della funzione, questo puntatore non sarà più valido.
-
pidl [in]
-
Tipo: LPCITEMIDLIST
Puntatore alla struttura ITEMIDLIST dell'elemento.
Valore restituito
Tipo: BOOL
TRUE per l'esito positivo, FALSE per errore.
Commenti
Nota
A partire da Shell32.dll versione 5.0, la chiamata a questa funzione equivale a chiamare StrRetToBuf.
StrRetToStrN non viene esportato in base al nome. Per usarlo, è necessario usare GetProcAddress e richiedere il numero ordinale 96 da Shell32.dll per ottenere un puntatore a funzione.
Se il membro uType della struttura a cui punta pStrRet è impostato su STRRET_WSTR, il membro pOleStr di tale struttura verrà liberato al ritorno.
Si noti che questa funzione viene esportata da Shell32.dll anziché da Shlwapi.dll. È incluso anche in Shlobj.h anziché in Shlwapi.h.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional, Windows XP [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| DLL |
|
Vedi anche