NetMessageNameAdd

NetMessageNameAdd 関数は、メッセージ名テーブルにメッセージエイリアスを登録する。この関数は messenger サービスが開始されている必要がある。

NetMessageNameAdd servername, msgname

servername : [wstr] 関数を実行するリモートサーバーの DNS または NetBIOS 名を指定する定数文字列へのポインタ。このパラメータが NULL の場合、ローカルコンピューターが使われる。
msgname : [wstr] 追加するメッセージエイリアスを指定する定数文字列へのポインタ。文字列は 15 文字を超えることはできない。

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

解説

NetMessageNameAdd 関数は、メッセージ名テーブルにメッセージエイリアスを登録する。この関数は messenger
サービスが開始されている必要がある。

[戻り値]
関数が成功した場合、戻り値は NERR_Success となる。失敗した場合、戻り値は次のいずれかのエラーコードになる可能性がある。
(以下省略)

[備考]
リモートサーバー上で NetMessageNameAdd 関数を正常に実行できるのは、Administrators
ローカルグループのメンバーだけである。メッセージ転送はもはやサポートされていないため、LAN Manager 2.x の
NetMessageNameAdd 関数にあった forward action
フラグは、もはやパラメータではない。NetMessageNameAdd 関数が、ネットワーク上に msgname
の転送バージョンが存在することを検出した場合、関数は NERR_Already_Exists エラーで失敗する。

情報

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