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。

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

值 意義
ERROR_REVISION_MISMATCH
 傳遞的版本無效或不受支援。
ERROR_INVALID_PARAMETER
 pServerSessionId參數為 Null，或保留為非零。

備註

伺服器會話擁有一組 URL 群組。 它們是最上層的組態容器，適用于套用至其下建立之所有 URL 群組的組態資訊。 如需設定伺服器會話的詳細資訊，請參閱 HttpSetServerSessionProperty。

HTTP 伺服器 API 不支援伺服器會話的非同步 I/O。

當不再需要伺服器會話，或在應用程式終止之前，應用程式必須呼叫 HttpCloseServerSession來刪除伺服器會話。 刪除伺服器會話時，也會自動刪除所有相關聯的 URL 群組。

需求

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

另請參閱

HTTP Server API 2.0 版函式

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty