Funzione StrRetToBufA (shlwapi.h)
Converte una struttura STRRET restituita da IShellFolder::GetDisplayNameOf in una stringa e inserisce il risultato in un buffer.
Sintassi
LWSTDAPI StrRetToBufA(
[in, out] STRRET *pstr,
[in] PCUITEMID_CHILD pidl,
[out] LPSTR pszBuf,
[in] UINT cchBuf
);
Parametri
[in, out] pstr
Tipo: STRRET*
Puntatore alla struttura STRRET . Al termine della funzione, questo puntatore non sarà più valido.
[in] pidl
Tipo: PCUITEMID_CHILD
Puntatore alla struttura ITEMIDLIST dell'elemento.
[out] pszBuf
Tipo: LPTSTR
Buffer in cui contenere il nome visualizzato. Verrà restituito come stringa con terminazione Null. Se cchBuf è troppo piccolo, il nome verrà troncato per adattarsi.
[in] cchBuf
Tipo: UINT
Dimensioni di pszBuf, in caratteri. Se cchBuf è troppo piccolo, la stringa verrà troncata per adattarsi.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Se il membro uType della struttura a cui punta pstr è impostato su STRRET_WSTR, il membro pOleStr di tale struttura verrà liberato al ritorno.
Nota
L'intestazione shlwapi.h definisce StrRetToBuf 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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) |