Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |