StrRetToStrN-Funktion

Verwendet eine strret-Struktur, die von IShellFolder::GetDisplayNameOfzurückgegeben wird, konvertiert sie in eine Zeichenfolge und platziert das Ergebnis in einen Puffer.

Syntax

BOOL StrRetToStrN(
  _Out_   LPTSTR        pszOut,
  _In_    UINT          cchOut,
  _Inout_ LPSTRRET      pStrRet,
  _In_    LPCITEMIDLIST pidl
);

Parameter

pszOut [ out]

Typ: LPTSTR

Puffer zum Halten des Anzeigenamens. Sie wird als auf NULL beendete Zeichenfolge zurückgegeben. Wenn cchOut zu klein ist, wird der Name abgeschnitten, damit er passt.

cchOut [ In]

Typ: UINT

Größe von pszOut in Zeichen. Wenn cchOut zu klein ist, wird die Zeichenfolge abgeschnitten, damit sie passt.

pStrRet [ in, out]

Typ: LPSTRRET

Zeiger auf eine STRRET-Struktur. Wenn die Funktion zurückgegeben wird, ist dieser Zeiger nicht mehr gültig.

pidl [ In]

Typ: LPJSMIDLIST

Zeiger auf die ITEMIDLIST-Struktur des Elements.

Rückgabewert

Typ: BOOL

TRUE für Erfolg, FALSE für Fehler.

Bemerkungen

Hinweis

Ab Version Shell32.dll 5.0 entspricht das Aufrufen dieser Funktion dem Aufrufen von StrRetToBuf.

StrRetToStrN wird nicht nach Namen exportiert. Um sie zu verwenden, müssen Sie GetProcAddress verwenden und die Ordnungszahl 96 von Shell32.dll anfordern, um einen Funktionszeiger zu erhalten.

Wenn der uType-Member der Struktur, auf den pStrRet zeigt, auf STRRET _ WSTR festgelegt ist, wird der pOleStr-Member dieser Struktur bei der Rückgabe frei.

Beachten Sie, dass diese Funktion nicht aus Shell32.dll, sondern aus Shlwapi.dll. Sie ist auch in Shlobj.h und nicht in Shlwapi.h enthalten.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional nur Windows [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
DLL
Shell32.dll (Version 4.71 oder höher)

Weitere Informationen

StrRetToStr

StrRetToBuf