HttpAddUrlToUrlGroup

URL グループ ID で識別される URL グループに指定 URL を追加する。

HttpAddUrlToUrlGroup UrlGroupId, pFullyQualifiedUrl, UrlContext, Reserved

UrlGroupId : [int64] 指定 URL へのリクエストをルーティングする URL グループのグループ ID。URL グループは HttpCreateUrlGroup 関数で作成される。
pFullyQualifiedUrl : [wstr] 登録する URL を識別する、正しく形成された UrlPrefix 文字列を含む Unicode 文字列へのポインタ。管理者として実行していない場合は 1024 より大きいポート番号を指定すること。そうでない場合 ERROR_ACCESS_DENIED が発生する可能性がある。
UrlContext : [int64] この呼び出しで登録される URL に関連付けられるコンテキスト。URL コンテキストは pFullyQualifiedUrl で指定された URL で受信される全てのリクエストの HTTP_REQUEST 構造体で返される。
Reserved : [int] 予約されている。0 でなければならない。

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

解説

URL グループ ID で識別される URL グループに指定 URL を追加する。

[戻り値]
関数が成功すると NO_ERROR を返す。関数が失敗した場合、次のいずれかのエラーコードを返す。このドキュメントは省略されている。

[備考]
HTTP Server API はバージョン 1.0 の URL 登録を使用する既存アプリケーションをサポートするが、新規開発では
HttpAddUrlToUrlGroup を使用すべきで、HttpAddUrl
は使用すべきではない。HttpAddUrlToUrlGroup を繰り返し呼ぶことで URL グループに複数の URL
を追加できる。合致するリクエストは URL グループに関連付けられたリクエストキューにルーティングされる。

情報

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