SHStrDupA 函式 (shlwapi.h)
在新配置的記憶體中建立字串的複本。
語法
LWSTDAPI SHStrDupA(
[in] LPCSTR psz,
[out] LPWSTR *ppwsz
);
參數
[in] psz
類型:LPCTSTR
要複製之 Null 終止字串的指標。
[out] ppwsz
類型:LPTSTR*
包含結果之已配置 Unicode 字串的指標。 SHStrDup 使用 CoTaskMemAlloc配置此字串的記憶體。 當不再需要字串時,您應該使用 CoTaskMemFree 釋放字串。
如果失敗,此值為 NULL。
傳回值
類型:HRESULT
如果成功,則傳回S_OK,否則會傳回 COM 錯誤值。
言論
此函式會採用 Unicode 或 ANSI 字串作為輸入,但複製的字串一律為 Unicode。
此函式會使用 CoTaskMemAlloc 來配置複製字串的記憶體。 當您不再需要此記憶體時,您必須使用 CoTaskMemFree 釋放此記憶體。
注意
shlwapi.h 標頭會將SHStrDup定義為別名,根據UNICODE預處理器常數的定義,自動選取此函式的ANSI或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | shlwapi.h |
連結庫 | Shlwapi.lib |
DLL | Shlwapi.dll 版 (5.0 版或更新版本) |