Fungsi StrRetToBSTR (shlwapi.h)

Menerima struktur STRRET yang dikembalikan oleh IShellFolder::GetDisplayNameOf yang berisi atau menunjuk ke string, dan mengembalikan string tersebut sebagai BSTR.

Sintaks

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

Parameter

[in, out] pstr

Jenis: STRRET*

Penunjuk ke struktur STRRET . Ketika fungsi kembali, penunjuk ini lebih valid.

[in] pidl

Jenis: PCUITEMID_CHILD

Penunjuk ke ITEMIDLIST yang secara unik mengidentifikasi objek file atau subfolder relatif terhadap folder induk. Nilai ini bisa NULL.

[out] pbstr

Jenis: BSTR*

Penunjuk ke variabel jenis BSTR yang menerima string yang dikonversi.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika anggota uType dari struktur STRRET yang ditujukan oleh pstr diatur ke STRRET_WSTR, anggota pOleStr dari struktur tersebut dibebaskan saat dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.5 atau yang lebih baru)

Lihat juga

IShellFolder::GetDisplayNameOf

StrRetToBuf

StrRetToStr