StrRetToBSTR-Funktion (shlwapi.h)
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) |