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 |
|