WindowsGetStringRawBuffer 関数 (winstring.h)

指定した文字列のバッキング バッファーを取得します。

構文

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

パラメーター

string

型: [in, optional] HSTRING

バッキング バッファーを取得する省略可能な文字列。 NULL を指定できます。

length

型: [out, optional] UINT32 *

UINT32 への省略可能なポインター。 長さに対して NULL が渡された場合は無視されます。 length が UINT32 への有効なポインターであり、string が有効な HSTRING である場合、正常に完了すると、関数は長さが指す値を文字列のバッキング バッファー内の Unicode 文字の数に設定します (埋め込まれた null 文字を含みますが、終端の null は除きます)。 length が UINT32 への有効なポインターで、string が NULL の場合、length によって指される値は 0 に設定されます。

戻り値

種類: PCWSTR

string のバッキング ストアを提供するバッファーへのポインター。string が NULL または空の文字列の場合は空の文字列。

注釈

HSTRING のバッキング バッファーへのポインターを取得するには、WindowsGetStringRawBuffer 関数を使用します。

バッファーの内容を変更しないでください。 HSTRING は不変である必要があります。

要件

サポートされている最小のクライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	winstring.h