HttpInitialize 関数 (http.h)

  • [アーティクル]

HttpInitialize 関数は、HTTP Server API ドライバーを初期化し、まだ開始されていない場合は起動し、呼び出し元のアプリケーションに対してデータ構造を割り当てて、応答キューの作成やその他の操作をサポートします。 HTTP Server API で他の関数を呼び出す前に、この関数を呼び出します。

構文

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

パラメーター

[in] Version

HTTP バージョン。 このパラメーターは 、HTTPAPI_VERSION 構造体です。 現在のバージョンでは、 構造体のインスタンスを宣言し、HttpInitialize に渡す前にHTTPAPI_VERSION_1定義済みの値に設定します。

[in] Flags

初期化オプション。次の値のいずれかまたは両方を含めることができます。

値 意味
HTTP_INITIALIZE_CONFIG
 HTTP 構成関数、HttpSetServiceConfiguration、HttpQueryServiceConfiguration、HttpDeleteServiceConfiguration、HttpIsFeatureSupported を使用するアプリケーションの初期化を実行します。
HTTP_INITIALIZE_SERVER
 HTTP Server API を使用するアプリケーションの初期化を実行します。

[in, out] pReserved

このパラメーターは予約済みであり、 NULL である必要があります。

戻り値

関数が成功した場合、戻り値は NO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

値 意味
ERROR_INVALID_PARAMETER
 Flags パラメーターには、サポートされていない値が含まれています。
その他
 WinError.h で定義されている システム エラー コード 。

注釈

アプリケーションの完了時に HttpTerminate を呼び出します。 Flags パラメーターで HttpInitialize に渡されたのと同じ フラグ はすべて 、HttpTerminate にも渡す必要があります。 HttpInitialize の各呼び出しが後で HttpTerminate の対応する呼び出しと一致する場合、アプリケーションは HttpInitialize を繰り返し呼び出すことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー http.h
Library Httpapi.lib
[DLL] Httpapi.dll

こちらもご覧ください