HttpAddUrl

指定された URL を登録し、合致するリクエストが HTTP Server API の指定リクエストキューにルーティングされるようにする。

HttpAddUrl RequestQueueHandle, FullyQualifiedUrl, Reserved

RequestQueueHandle : [intptr] 指定 URL へのリクエストをルーティングするリクエストキューへのハンドル。リクエストキューは HttpCreateRequestQueue 関数で作成される。Windows Server 2003 SP1 および Windows XP SP2 ではハンドルは HttpCreateHttpHandle により作成される。
FullyQualifiedUrl : [wstr] 登録する URL を識別する、正しく形成された UrlPrefix 文字列を含む Unicode 文字列へのポインタ。
Reserved : [intptr] 予約されている。NULL でなければならない。

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

解説

指定された URL を登録し、合致するリクエストが HTTP Server API の指定リクエストキューにルーティングされるようにする。

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

[備考]
UrlPrefix 文字列トピックにあるとおり、登録する UrlPrefix のスキーム指定は小文字の "http" か "https"
のみ有効である。同一ポートで異なるスキームの URL を登録することはできない ("http" と "https"
は同一ポート上で共存できない)。HttpAddUrl は文字列が正しく形成されている限り渡された UrlPrefix
を登録する。指定された URL 名前空間の存在・アクセス可否・所有権等の検証はアプリケーション側で行う必要がある。HttpAddUrl
による登録で確保したリソースを解放するには、名前空間の利用が終わった時点で対応する HttpRemoveUrl を呼び出す。

情報