SysAllocStringLen

新しい文字列を割り当て、渡された文字列から指定された文字数をコピーし、null 終端文字を追加する。

SysAllocStringLen strIn, ui

strIn : [wstr] 入力文字列。
ui : [int] コピーする文字数。後に null 文字が置かれ、合計で ui に 1 を加えた文字数が割り当てられる。

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

解説

新しい文字列を割り当て、渡された文字列から指定された文字数をコピーし、null 終端文字を追加する。

[戻り値]
文字列のコピー。操作を完了するためのメモリが不足している場合は NULL。

[備考]
文字列は埋め込み null 文字を含むことができ、NULL で終わる必要はない。返される文字列は後で SysFreeString
で解放する。strIn が NULL でない場合、strIn に割り当てられたメモリは少なくとも ui
文字以上の長さでなければならない。注意: この関数は char * 文字列を Unicode BSTR に変換しない。

情報

プラグイン / モジュールoleaut32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の oleaut32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_oleaut32_gen2.hs