SHLocalStrDupA 函式 (shlwapi.h)

在新配置的記憶體中建立字串複本。

語法

HRESULT SHLocalStrDupA(
                  PCSTR psz,
  [out, optional] PSTR  *ppsz
);

psz

類型： PCTSTR

要複製之 Null 終止 Unicode 字串的指標。

[out, optional] ppsz

類型： PTSTR*

當此函式成功傳回時，所配置字串的指標位址會接收結果。 SHLocalStrDup 會使用 LocalAlloc配置此字串的記憶體。當不再需要字串時，您應該使用 LocalFree 釋出字串。

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

注意

shlwapi.h 標頭會將SHLocalStrDup定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或Unicode版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。