SysReAllocStringLen 関数 (oleauto.h)
古い BSTR から指定した文字数を含む新しい BSTR を作成し、古い BSTR を解放します。
構文
INT SysReAllocStringLen(
[in, out] BSTR *pbstr,
[in, optional] const OLECHAR *psz,
[in] unsigned int len
);
パラメーター
[in, out] pbstr
以前に割り当てられた文字列。
[in, optional] psz
len 文字のコピー元の文字列。初期化されていない文字列を保持する場合は NULL。
[in] len
コピーする文字数。 その後、null 文字が配置され、 len の合計と 1 文字が割り当てられます。
戻り値
リターン コード | 説明 |
---|---|
|
文字列が正常に再割り当てされました。 |
|
メモリが不足しています。 |
注釈
新しい文字列を割り当て、渡された文字列から len 文字をコピーし、null 文字を追加します。 pbstr によって現在参照されている BSTR を解放し、pbstr をリセットして新しい BSTR を指します。 psz が null の場合、長さ len の文字列は割り当てられますが、初期化されません。
psz 文字列には null 文字を埋め込むことができます。null で終わる必要はありません。
この関数に NULL ポインターが渡されると、アクセス違反が発生し、プログラムがクラッシュします。 この関数は NULL ポインターから保護する必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | oleauto.h |
Library | OleAut32.lib |
[DLL] | OleAut32.dll |