StrRetToBSTR-Funktion (shlwapi.h)

  • Artikel

Akzeptiert eine STRRET-Struktur , die von IShellFolder::GetDisplayNameOf zurückgegeben wird, die eine Zeichenfolge enthält oder darauf verweist, und gibt diese Zeichenfolge als BSTR zurück.

Syntax

LWSTDAPI StrRetToBSTR(
  [in, out] STRRET          *pstr,
  [in]      PCUITEMID_CHILD pidl,
  [out]     BSTR            *pbstr
);

Parameter

[in, out] pstr

Typ: STRRET*

Ein Zeiger auf eine STRRET-Struktur . Wenn die Funktion zurückgegeben wird, ist dieser Zeiger länger gültig.

[in] pidl

Typ: PCUITEMID_CHILD

Ein Zeiger auf eine ITEMIDLIST , die ein Dateiobjekt oder einen Unterordner relativ zum übergeordneten Ordner eindeutig identifiziert. Dieser Wert kann NULL sein.

[out] pbstr

Typ: BSTR*

Ein Zeiger auf eine Variable vom Typ BSTR , die die konvertierte Zeichenfolge empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der uType-Member der STRRET-Struktur , auf die pstr verweist, auf STRRET_WSTR festgelegt ist, wird das pOleStr-Element dieser Struktur bei der Rückgabe freigegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.5 oder höher)

Weitere Informationen

IShellFolder::GetDisplayNameOf

StrRetToBuf

StrRetToStr