共用方式為


StrRetToStrN 函式

接受IShellFolder::GetDisplayNameOf傳回的STRRET結構、將它轉換成字串,並將結果放在緩衝區中。

語法

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

參數

pszOut [out]

類型: LPTSTR

用來保存顯示名稱的緩衝區。 它會以 Null 終止的字串的形式傳回。 如果 cchOut 太小,則會截斷名稱以符合。

cchOut [in]

類型: UINT

pszOut的大小,以字元為單位。 如果 cchOut 太小,字串將會截斷以符合。

pStrRet [in, out]

類型: LPSTRRET

STRRET結構的指標。 當函式傳回時,此指標將不再有效。

pidl [in]

類型: LPCITEMIDLIST

專案的 ITEMIDLIST 結構的指標。

傳回值

類型: BOOL

TRUE 表示成功, FALSE 表示失敗。

備註

注意

從 Shell32.dll 5.0 版開始,呼叫此函式相當於呼叫 StrRetToBuf

 

StrRetToStrN 不會依名稱匯出。 若要使用它,您必須使用 GetProcAddress ,並從 Shell32.dll 要求序數 96 以取得函式指標。

如果pStrRet所指向結構的uType成員設定為STRRET_WSTR,則會在傳回時釋放該結構的pOleStr成員。

請注意,此函式是從 Shell32.dll 匯出,而不是Shlwapi.dll。 它也包含在 Shlobj.h 中,而不是 Shlwapi.h。

規格需求

需求
最低支援的用戶端
Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
DLL
Shell32.dll (4.71 版或更新版本)

另請參閱

StrRetToStr

StrRetToBuf