Funzione StrRetToBufA (shlwapi.h)

  • Articolo

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)

Vedi anche

StrRetToStr

StrRetToStrN