SysReAllocStringLen

古い BSTR から指定された文字数を含む新しい BSTR を作成し、古い BSTR を解放する。

SysReAllocStringLen pbstr, psz, len

pbstr : [var] 以前に割り当てられた文字列。
psz : [wstr] len 文字をコピーする元の文字列。文字列を未初期化のままにする場合は NULL。
len : [int] コピーする文字数。後に null 文字が置かれ、合計で len に 1 を加えた文字数が割り当てられる。

(プラグイン / モジュール : oleaut32.dll)

解説

古い BSTR から指定された文字数を含む新しい BSTR を作成し、古い BSTR を解放する。

[戻り値]
（以下省略）

[備考]
新しい文字列を割り当て、渡された文字列から len 文字をコピーし、その後に null 文字を追加する。pbstr が現在参照している
BSTR を解放し、pbstr を新しい BSTR を指すようにリセットする。psz が null の場合、長さ len
の文字列が割り当てられるが、初期化はされない。psz 文字列は埋め込み null 文字を含むことができ、null
で終わる必要はない。この関数に NULL ポインタが渡された場合、アクセス違反が発生してプログラムがクラッシュする。NULL
ポインタからこの関数を保護するのは利用者の責任である。

情報