HttpCreateUrlGroup 函式 (HTTP.h)

HttpCreateUrlGroup函式會在指定的伺服器會話下建立 URL 群組。

語法

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

參數

[in] ServerSessionId

建立 URL 群組的伺服器會話識別碼。

[out] pUrlGroupId

接收 URL 群組識別碼之變數的指標。

[in] Reserved

保留的。 必須為零。

傳回值

如果函式成功，它會傳回 NO_ERROR

如果函式失敗，它會傳回下列其中一個錯誤碼。

備註

URL 群組是一組 URL 的組態容器。 它們會在伺服器會話下建立，並繼承伺服器會話的組態設定。 在 URL 群組上設定組態參數時，它會覆寫伺服器會話上設定的組態。 如需 URL 群組設定組態的詳細資訊，請參閱 HttpSetUrlGroupProperty。

建立 URL 群組之後，它必須與要求佇列相關聯，才能接收要求。 若要將 URL 群組與要求佇列產生關聯，應用程式會呼叫 HttpSetUrlGroupProperty 與 HttpServerBindingProperty 屬性。 如果未設定此屬性，則不會將 URL 群組的相符要求傳遞至要求佇列，而 HTTP 伺服器 API 會產生 503 回應。

與要求佇列的 URL 群組關聯是動態的。 刪除伺服器會話或 URL 群組之前，無法變更與伺服器會話的關聯。 刪除伺服器會話時，也會自動關閉所有相關聯的 URL 群組。

URL 群組一開始會建立為空的群組。 URL 必須藉由呼叫 HttpAddUrlToUrlGroup來新增至群組。

應用程式可能會基於下列原因建立多個 URL 群組：

• 若要設定其正在接聽之 URL 名稱空間不同部分的不同組態。
• 若要針對其正在接聽之 URL 名稱空間的不同部分，設定不同的要求佇列。

應用程式應該盡可能將 URL 合併成群組;否則，效能將會降低，並增加系統的記憶體耗用量會影響延展性。

HTTP 伺服器 API 不支援 URL 群組上的非同步 I/O。

當不再需要 URL 群組，或在應用程式終止之前，必須呼叫 HttpCloseUrlGroup來刪除 URL 群組。

URL 群組是以與其建立所在的伺服器會話相同的版本建立。

需求

另請參閱

HTTP Server API 2.0 版函式

HttpAddUrlToUrlGroup

HttpCloseUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

HttpSetUrlGroupProperty