Funzione StrRetToBufA (shlwapi.h)

Articolo
11/20/2024

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 . Quando la funzione viene restituita, 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.

Osservazioni

Se il membro uType della struttura a cui punta pstr viene 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 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

StrRetToStr

StrRetToStrN

Condividi tramite