StrRetToStrN-Funktion
Verwendet eine STRRET-Struktur , die von IShellFolder::GetDisplayNameOf zurückgegeben wird, konvertiert sie in eine Zeichenfolge und platziert das Ergebnis in einem Puffer.
Syntax
BOOL StrRetToStrN(
_Out_ LPTSTR pszOut,
_In_ UINT cchOut,
_Inout_ LPSTRRET pStrRet,
_In_ LPCITEMIDLIST pidl
);
Parameter
-
pszOut [out]
-
Typ: LPTSTR
Puffer, der den Anzeigenamen enthält. Es wird als NULL-endende Zeichenfolge zurückgegeben. Wenn cchOut zu klein ist, wird der Name abgeschnitten.
-
cchOut [in]
-
Typ: UINT
Größe von pszOut in Zeichen. Wenn cchOut zu klein ist, wird die Zeichenfolge angepasst.
-
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: LPCITEMIDLIST
Zeiger auf die ITEMIDLIST-Struktur des Elements.
Rückgabewert
Typ: BOOL
TRUE für Erfolg, FALSE für Fehler.
Bemerkungen
Hinweis
Ab Shell32.dll Version 5.0 entspricht das Aufrufen dieser Funktion dem Aufrufen von StrRetToBuf.
StrRetToStrN wird nicht nach Name exportiert. Um sie zu verwenden, müssen Sie GetProcAddress verwenden und ordinal 96 von Shell32.dll anfordern, um einen Funktionszeiger abzurufen.
Wenn der uType-Member der Struktur, auf die pStrRet verweist, auf STRRET_WSTR festgelegt ist, wird der pOleStr-Member dieser Struktur bei der Rückgabe freigegeben.
Beachten Sie, dass diese Funktion aus Shell32.dll und nicht aus Shlwapi.dll exportiert wird. Es ist auch in Shlobj.h anstelle von Shlwapi.h enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| DLL |
|
Siehe auch