HttpCreateUrlGroup 函式 (HTTP.h)

發行項
08/24/2023

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

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

值	意義
ERROR_INVALID_PARAMETER	ServerSessionId參數表示不存在的伺服器會話。 pUrlGroupId參數為 null。 Reserved參數為非零。

值

意義

ERROR_INVALID_PARAMETER

ServerSessionId參數表示不存在的伺服器會話。

pUrlGroupId參數為 null。

Reserved參數為非零。

備註

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 群組是以與其建立所在的伺服器會話相同的版本建立。

需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	HTTP.h
程式庫	Httpapi.lib
Dll	Httpapi.dll