共用方式為

WindowsCreateString 函式 (winstring.h)

  • 發行項

根據指定的來源字串建立新的 HSTRING 。

語法

HRESULT WindowsCreateString(
  PCNZWCH sourceString,
  UINT32  length,
  HSTRING *string
);

參數

sourceString

Type： [in， optional] LPCWSTR

要作為新 HSTRING來源的 Null 終止字串。 若要建立新的、空白或Null字串，請針對sourceString傳遞Null，長度為 0。

length

類型： [in] UINT32

SourceString的長度，以 Unicode 字元表示。 如果 sourceString 為 Null，則必須為 0。

string

類型： [out] HSTRING*

新建立 HSTRING的指標，如果發生錯誤，則為 Null 。 會覆寫 字串 中的任何現有內容。 HSTRING是標準控制碼類型。

傳回值

類型： HRESULT

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

傳回碼 描述
S_OK
 已成功建立 HSTRING。
E_INVALIDARG
 字串 為 Null。
E_OUTOFMEMORY
 無法配置新的 HSTRING。
E_POINTER
 sourceString 為 Null ， 長度 為非零。

備註

使用 WindowsCreateString 函式來配置新的 HSTRING。 Windows 執行階段會將字串複製到新HSTRING的備份緩衝區，並使用參考計數來管理緩衝區存留期。 呼叫 WindowsCreateStringReference 函式來建立 快速傳遞字串，這會使用現有的字串而不復制它。

呼叫 WindowsDeleteString 函式以取消配置 HSTRING。 每次呼叫 WindowsCreateString 函式時，都必須符合 對 WindowsDeleteString的呼叫。

若要建立新的、空白或Null字串，請針對sourceString傳遞Null，長度為 0。

如果 sourceString 有內嵌的 Null 字元， WindowsCreateString 函式會將所有字元複製到終止的 Null 字元。

規格需求

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

另請參閱

WindowsCreateStringReference

WindowsDeleteString