SHStrDupW 函式 （shlwapi.h）
在新配置的記憶體中建立字串的複本。
語法
LWSTDAPI SHStrDupW(
[in] LPCWSTR 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 版或更新版本） |