HTTP_SERVICE_CONFIG_SSL_SNI_QUERY 結構 (HTTP.h)

HTTP_SERVICE_CONFIG_SSL_SNI_QUERY結構可用來指定特定的安全通訊端層 (SSL) 伺服器名稱指示 (SNI) 憑證記錄，以在 SSL SNI 存放區中查詢。 當ConfigId參數設定為HttpServiceConfigSslSniCertInfo時，它會使用pInputConfigInfo參數傳遞至HttpQueryServiceConfigConfiguration函式。

語法

typedef struct _HTTP_SERVICE_CONFIG_SSL_SNI_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE  QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc;
  DWORD                           dwToken;
} HTTP_SERVICE_CONFIG_SSL_SNI_QUERY, *PHTTP_SERVICE_CONFIG_SSL_SNI_QUERY;

成員

QueryDesc

HTTP_SERVICE_CONFIG_QUERY_TYPE 列舉的 下列其中一個值。

值	意義
HttpServiceConfigQueryExact	傳回單一 SSL SNI 憑證記錄。
HttpServiceConfigQueryNext	傳回一連串的 SSL SNI 憑證記錄，如 dwToken所控制。

KeyDesc

如果 QueryDesc 參數等於 HttpServiceConfigQueryExact， 則 KeyDesc 應該包含可識別查詢之 SSL SNI 憑證記錄 的HTTP_SERVICE_CONFIG_SSL_SNI_KEY 結構。 如果 QueryDesc 參數等於 HTTPServiceConfigQueryNext，則會忽略 KeyDesc 。

dwToken

如果 QueryDesc 參數等於 HTTPServiceConfigQueryNext，則 dwToken 在第一次呼叫 HttpQueryServiceConfiguration 函式時必須等於零，第二個呼叫上一個則為第二個呼叫，第二個呼叫則為二，依此類推，直到傳回所有 SSL 憑證記錄為止，此時 HttpQueryServiceConfiguration 會傳回ERROR_NO_MORE_ITEMS。

如果 QueryDesc 參數等於 HttpServiceConfigQueryExact，則會忽略 dwToken 。

需求

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

另請參閱

HTTP_SERVICE_CONFIG_SSL_SNI_KEY

HTTP_SERVICE_CONFIG_SSL_SNI_SET

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpSetServiceConfiguration