HttpCreateServerSession 函式 (HTTP.h)
HttpCreateServerSession函式會為指定的版本建立伺服器會話。
語法
HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
[in] HTTPAPI_VERSION Version,
[out] PHTTP_SERVER_SESSION_ID ServerSessionId,
[in] ULONG Reserved
);
參數
[in] Version
表示伺服器會話版本的HTTPAPI_VERSION結構。 針對 2.0 版，請先宣告 結構的實例，並將它設定為預先定義的值 HTTPAPI_VERSION_2 ，再將它傳遞至 HttpCreateServerSession。
版本必須是 2.0; HttpCreateServerSession 不支援 1.0 版要求佇列。
[out] ServerSessionId
接收伺服器會話識別碼之變數的指標。
[in] Reserved
保留的。 必須為零。
傳回值
如果函式成功，它會傳回 NO_ERROR。
如果函式失敗，它會傳回下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
傳遞的版本無效或不受支援。 |
|
pServerSessionId參數為 Null，或保留為非零。 |
備註
伺服器會話擁有一組 URL 群組。 它們是最上層的組態容器，適用于套用至其下建立之所有 URL 群組的組態資訊。 如需設定伺服器會話的詳細資訊，請參閱 HttpSetServerSessionProperty。
HTTP 伺服器 API 不支援伺服器會話的非同步 I/O。
當不再需要伺服器會話，或在應用程式終止之前，應用程式必須呼叫 HttpCloseServerSession來刪除伺服器會話。 刪除伺服器會話時，也會自動刪除所有相關聯的 URL 群組。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | HTTP.h |
| 程式庫 | Httpapi.lib |
| Dll | Httpapi.dll |