HttpAddUrlToUrlGroup 関数 (http.h)

HttpAddUrlToUrlGroup 関数は、指定した URL を URL グループ ID で識別される URL グループに追加します。

この関数は、HTTP バージョン 1.0 HttpAddUrl 関数を置き換えます。

構文

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

パラメーター

[in] UrlGroupId

指定した URL の要求がルーティングされる URL グループのグループ ID。 URL グループは、 HttpCreateUrlGroup 関数によって作成されます。

[in] pFullyQualifiedUrl

登録する URL を識別する適切な形式の UrlPrefix 文字列 を含む Unicode 文字列へのポインター。 管理者として実行していない場合は、1024 より大きいポート番号を指定します。そうしないと、ERROR_ACCESS_DENIED エラーが発生する可能性があります。

[in, optional] UrlContext

この呼び出しに登録されている URL に関連付けられているコンテキスト。 URL コンテキストは、pFullyQualifiedUrl パラメーターで指定された URL で受信したすべての要求を使用して、HTTP_REQUEST構造体で返されます。

[in] Reserved

予約済み。 ゼロを指定してください。

戻り値

関数が成功した場合は、NO_ERRORを返します

関数が失敗すると、次のいずれかのエラー コードが返されます。

注釈

HTTP Server API では、バージョン 1.0 の URL 登録を使用する既存のアプリケーションがサポートされていますが、HTTP Server API を使用した新しい開発では HttpAddUrlToUrlGroup を使用する必要があります。 HttpAddUrl は 使用しないでください。

アプリケーションでは、 HttpAddUrlToUrlGroup への繰り返しの呼び出しを使用して、URL グループに複数の URL を追加できます。 指定した URL に一致する要求は、URL グループに関連付けられている要求キューにルーティングされます。 HTTP Server API が登録された URL に対する要求 URL と一致する方法の詳細については、「 UrlPrefix 文字列」を参照してください。

要件

こちらもご覧ください

HTTP Server API バージョン 2.0 関数

HttpAddUrl

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

HttpSetUrlGroupProperty

UrlPrefix Strings (UrlPrefix 文字列)