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 |
|
另請參閱