WindowsGetStringRawBuffer 函式 (winstring.h)

  • 發行項

擷取指定字串的備份緩衝區。

語法

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

參數

string

類型：[in， 選擇性] HSTRING

要擷取備份緩衝區的選擇性字串。 可以是 NULL。

length

類型：[out，選擇性] UINT32 *

UINT32 的選擇性指標。 如果為長度傳遞 NULL，則會忽略它。 如果 length 是 UINT32 的有效指標，而且 字串 是有效的 HSTRING，則成功完成時，函式會將 長度 所指向的值設定為 (字元串 支援緩衝區中的 Unicode 字元數目，包括內嵌的 Null 字元，但不包括終止的 null) 。 如果 length 是 UINT32 的有效指標，而 字串 為 NULL，則 長度 所指向的值會設定為 0。

傳回值

類型： PCWSTR

提供 字串備份存放區的緩衝區指標，如果 字串 為 NULL 或空字串，則為空字串。

備註

使用 WindowsGetStringRawBuffer 函式來取得 HSTRING 備份緩衝區的指標。

請勿變更緩衝區的內容—需要 HSTRING 才能不可變。

規格需求

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