共用方式為

HTTP_SERVICE_CONFIG_SSL_CCS_QUERY結構 (HTTP.h)

  • 發行項

指定安全套接字層 (SSL) 組態，以在呼叫 HttpQueryServiceConfiguration 函式時查詢埠上的 SSL 集中式證書存儲 (CCS) 記錄。 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

下列其中一個值來自 HTTP_SERVICE_CONFIG_QUERY_TYPE 列舉，指出 呼叫 HttpQueryServiceConfiguration 是否為擷取單一記錄的呼叫，或是擷取一連串記錄之呼叫的一部分。

值 意義
HttpServiceConfigQueryExact
 呼叫 HttpQueryServiceConfiguration 會呼叫 以擷取 KeyDesc 成員指定的單一 SSL CCS 憑證記錄。
HttpServiceConfigQueryNext
 呼叫 HttpQueryServiceConfiguration 是呼叫序列的一部分，用來擷取 SSL CCS 憑證記錄序列。 dwToken 成員的值會控制此呼叫 HttpQueryServiceConfiguration 所擷取的順序記錄。

KeyDesc

如果 QueryDesc 成員等於 HttpServiceConfigQueryExact，則為識別所查詢 SSL CCS 憑證記錄的HTTP_SERVICE_CONFIG_SSL_CCS_KEY結構。 如果 QueryDesc 等於 HTTPServiceConfigQueryNext，則會忽略。

dwToken

如果 QueryDesc 方法等於 HTTPServiceConfigQueryNext，則此呼叫 HttpQueryServiceConfiguration 的記錄序列中記錄的位置應該從零開始擷取。 換句話說，第一次呼叫 HttpQueryServiceConfiguration 函式時，dwToken 必須等於零，第二次呼叫時必須等於 1，第三次呼叫則為 2，依此類推。 當呼叫序列傳回所有 SSL 憑證記錄時， HttpQueryServiceConfiguration 會 傳回ERROR_NO_MORE_ITEMS。 如果 QueryDesc 等於 HttpServiceConfigQueryExact，則會忽略。

備註

當 ConfigId 參數設定為 HttpServiceConfigSslCcsCertInfo 時，請使用 pInputConfigInfo 參數將此結構傳遞至 HttpQueryServiceConfigConfiguration 函式。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
標頭 http.h

另請參閱

HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_SSL_CCS_KEY

HttpQueryServiceConfiguration