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 是否為擷取單一記錄的呼叫,或是擷取一連串記錄之呼叫的一部分。
值 | 意義 |
---|---|
|
呼叫 HttpQueryServiceConfiguration 會呼叫 以擷取 KeyDesc 成員指定的單一 SSL CCS 憑證記錄。 |
|
呼叫 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