WindowsGetStringRawBuffer 関数 (winstring.h)

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

構文

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

パラメーター

string

型: [in, optional] HSTRING

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

length

型: [out, optional] UINT32 *

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

戻り値

型: PCWSTR

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

注釈

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

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

Requirements