HttpCreateServerSession 関数 (http.h)

[アーティクル]
08/24/2023

HttpCreateServerSession 関数は、指定したバージョンのサーバーセッションを作成します。

構文

HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
  [in]  HTTPAPI_VERSION         Version,
  [out] PHTTP_SERVER_SESSION_ID ServerSessionId,
  [in]  ULONG                   Reserved
);

パラメーター

[in] Version

サーバーセッションのバージョンを示すHTTPAPI_VERSION構造体。バージョン 2.0 では、構造体のインスタンスを宣言し、HttpCreateServerSession に渡す前に、定義済みの値HTTPAPI_VERSION_2に設定します。

バージョンは 2.0 である必要があります。 HttpCreateServerSession では、バージョン 1.0 の要求キューはサポートされていません。

[out] ServerSessionId

サーバーセッションの ID を受け取る変数へのポインター。

[in] Reserved

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

戻り値

関数が成功すると、 NO_ERRORが返されます。

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

値	説明
ERROR_REVISION_MISMATCH	渡されたバージョンが無効であるか、サポートされていません。
ERROR_INVALID_PARAMETER	pServerSessionId パラメーターが null であるか、予約が 0 以外です。

解説

サーバーセッションは、一連の URL グループを所有します。これらは、その下に作成されたすべての URL グループに適用される構成情報の最上位レベルの構成コンテナーです。サーバーセッションの構成の詳細については、「 HttpSetServerSessionProperty」を参照してください。

HTTP Server API では、サーバーセッションの非同期 I/O はサポートされていません。

サーバーセッションが不要になった場合、またはアプリケーションが終了する前に、アプリケーションは HttpCloseServerSession を呼び出してサーバーセッションを削除する必要があります。サーバーセッションが削除されると、関連付けられているすべての URL グループも自動的に削除されます。

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	http.h
Library	Httpapi.lib
[DLL]	Httpapi.dll

HttpCreateServerSession 関数 (http.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース