Fungsi StrRetToStrN

Artikel
06/13/2023

Mengambil struktur STRRET yang dikembalikan oleh IShellFolder::GetDisplayNameOf, mengonversinya menjadi string, dan menempatkan hasilnya dalam buffer.

Sintaks

BOOL StrRetToStrN(
  _Out_   LPTSTR        pszOut,
  _In_    UINT          cchOut,
  _Inout_ LPSTRRET      pStrRet,
  _In_    LPCITEMIDLIST pidl
);

Parameter

pszOut [out]

Jenis: LPTSTR

Buffer untuk menahan nama tampilan. Ini akan dikembalikan sebagai string yang dihentikan null. Jika cchOut terlalu kecil, nama akan dipotok agar pas.

cchOut [in]

Jenis: UINT

Ukuran pszOut, dalam karakter. Jika cchOut terlalu kecil, string akan dipotok agar pas.

pStrRet [masuk, keluar]

Jenis: LPSTRRET

Penunjuk ke struktur STRRET . Ketika fungsi kembali, penunjuk ini tidak akan valid lagi.

pidl [in]

Jenis: LPCITEMIDLIST

Penunjuk ke struktur ITEMIDLIST item.

Mengembalikan nilai

Jenis: BOOL

TRUE untuk keberhasilan, FALSE untuk kegagalan.

Keterangan

Catatan

Pada Shell32.dll versi 5.0, memanggil fungsi ini setara dengan memanggil StrRetToBuf.

StrRetToStrN tidak diekspor berdasarkan nama. Untuk menggunakannya, Anda harus menggunakan GetProcAddress dan meminta ordinal 96 dari Shell32.dll untuk mendapatkan penunjuk fungsi.

Jika anggota uType struktur yang diacu oleh pStrRet diatur ke STRRET_WSTR, anggota pOleStr dari struktur tersebut akan dibebaskan saat dikembalikan.

Perhatikan bahwa fungsi ini diekspor dari Shell32.dll daripada Shlwapi.dll. Ini juga termasuk dalam Shlobj.h daripada Shlwapi.h.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Lihat juga

StrRetToStr
StrRetToBuf

Bagikan melalui