共用方式為


WindowsDuplicateString 函式 (winstring.h)

建立指定字串的複本。

語法

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

參數

string

類型: [in] HSTRING

要複製的字串。

newString

類型: [out] HSTRING*

字串的複本。

傳回值

類型: HRESULT

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

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

備註

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

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

規格需求

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

另請參閱

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString