HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 構造体 (http.h)

  • [アーティクル]

HttpQueryServiceConfiguration 関数を呼び出すときに、ポートで SSL 一元化証明書ストア (CCS) レコードを照会する Secure Sockets Layer (SSL) 構成を指定します。 SSL 証明書レコードは、ポートがトランスポート層セキュリティ (TLS) ハンドシェイクを受け取った場合に、Http.sys が CCS ストアを参照して証明書を見つける必要があることを指定します。

構文

typedef struct _HTTP_SERVICE_CONFIG_SSL_CCS_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE  QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_CCS_KEY KeyDesc;
  DWORD                           dwToken;
} HTTP_SERVICE_CONFIG_SSL_CCS_QUERY, *PHTTP_SERVICE_CONFIG_SSL_CCS_QUERY;

メンバー

QueryDesc

HttpQueryServiceConfiguration の呼び出しが 1 つのレコードを取得する呼び出しであるか、またはレコードのシーケンスを取得するための一連の呼び出しの一部であるかを示す、HTTP_SERVICE_CONFIG_QUERY_TYPE列挙体の次のいずれかの値。

値 意味
HttpServiceConfigQueryExact
 HttpQueryServiceConfiguration の呼び出しは、 を呼び出して、KeyDesc メンバーが指定する 1 つの SSL CCS 証明書レコードを取得します。
HttpServiceConfigQueryNext
 HttpQueryServiceConfiguration の呼び出しは、SSL CCS 証明書レコードのシーケンスを取得するための一連の呼び出しの一部です。 dwToken メンバーの値は、この HttpQueryServiceConfiguration の呼び出しによって取得されるシーケンス内のレコードを制御します。

KeyDesc

QueryDesc メンバーが HttpServiceConfigQueryExact と等しい場合に照会される SSL CCS 証明書レコードを識別するHTTP_SERVICE_CONFIG_SSL_CCS_KEY構造体。 QueryDesc が HTTPServiceConfigQueryNext と等しい場合は無視されます。

dwToken

QueryDesc メソッドが 0 から始まる HTTPServiceConfigQueryNext と等しい場合に、この HttpQueryServiceConfiguration の呼び出しで取得する必要があるレコードのシーケンス内のレコードの位置。 つまり、httpQueryServiceConfiguration 関数の最初の呼び出しでは dwToken が 0、2 番目の呼び出しでは 1、3 番目の呼び出しでは 2 と等しい必要があります。 一連の呼び出しですべての SSL 証明書レコードが返されると、 HttpQueryServiceConfiguration は ERROR_NO_MORE_ITEMSを返します。 QueryDesc が HttpServiceConfigQueryExact と等しい場合は無視されます。

注釈

ConfigId パラメーターが HttpServiceConfigSslCcsCertInfo に設定されている場合は、pInputConfigInfo パラメーターを使用して、この構造体を HttpQueryServiceConfiguration 関数に渡します。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
Header http.h

こちらもご覧ください

HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_SSL_CCS_KEY

HttpQueryServiceConfiguration