StrRetToBufA-Funktion (shlwapi.h)
Konvertiert eine STRRET- Struktur, die von IShellFolder::GetDisplayNameOf in eine Zeichenfolge zurückgegeben wird, und platziert das Ergebnis in einen Puffer.
Syntax
LWSTDAPI StrRetToBufA(
[in, out] STRRET *pstr,
[in] PCUITEMID_CHILD pidl,
[out] LPSTR pszBuf,
[in] UINT cchBuf
);
Parameter
[in, out] pstr
Typ: STRRET-*
Ein Zeiger auf die STRRET- Struktur. Wenn die Funktion zurückgegeben wird, ist dieser Zeiger nicht mehr gültig.
[in] pidl
Typ: PCUITEMID_CHILD
Ein Zeiger auf die ITEMIDLIST Struktur des Elements.
[out] pszBuf
Typ: LPTSTR-
Ein Puffer, der den Anzeigenamen enthalten soll. Sie wird als null-beendete Zeichenfolge zurückgegeben. Wenn cchBuf zu klein ist, wird der Name abgeschnitten, damit er passt.
[in] cchBuf
Typ: UINT-
Die Größe pszBufin Zeichen. Wenn cchBuf- zu klein ist, wird die Zeichenfolge abgeschnitten, damit sie passen.
Rückgabewert
Typ: HRESULT-
Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Wenn das uType Element der Struktur, auf das durch pstr- verwiesen wird, auf STRRET_WSTRfestgelegt ist, wird das pOleStr Element dieser Struktur zurückgegeben.
Anmerkung
Der Header "shlwapi.h" definiert StrRetToBuf als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shlwapi.h |
| Library | Shlwapi.lib |
| DLL- | Shlwapi.dll (Version 5.0 oder höher) |