Share via

WindowsDuplicateString 函式 (winstring.h)

  • 發行項

建立指定字串的複本。

語法

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

參數

string

類型： [in] HSTRING

要複製的字串。

newString

類型： [out] HSTRING*

字串的複本。

傳回值

類型： HRESULT

此函式可以傳回其中一個值。

傳回碼 描述
S_OK
 已成功複製 HSTRING。
E_INVALIDARG
 newString 為 NULL。
E_OUTOFMEMORY
 無法配置新的 HSTRING。

備註

使用 WindowsDuplicateString 函式來複製 HSTRING。 如果 字串 是藉由呼叫 WindowsCreateString 函式所建立，則會遞增備份緩衝區的參考計數。 如果字串是藉由呼叫 WindowsCreateStringReference 函式所建立，則 Windows 執行階段 將其來源字串複製到新的緩衝區，並啟動參考計數，這表示 newString 不是快速傳遞字串。

WindowsDuplicateString 函式的每個呼叫都必須與對應的 WindowsDeleteString 呼叫相符。

規格需求

需求 值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winstring.h

另請參閱

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString