HTTP_SERVER_AUTHENTICATION_INFO 結構 (HTTP.h)

  • 發行項

HTTP_SERVER_AUTHENTICATION_INFO結構可用來在 URL 群組或伺服器會話上啟用伺服器端驗證。 這個結構也可用來查詢為 URL 群組或伺服器會話啟用的現有驗證配置。

在 URL 群組或伺服器會話上設定或查詢 HttpServerAuthenticationProperty 時，必須使用這個結構。

語法

typedef struct _HTTP_SERVER_AUTHENTICATION_INFO {
  HTTP_PROPERTY_FLAGS                      Flags;
  ULONG                                    AuthSchemes;
  BOOLEAN                                  ReceiveMutualAuth;
  BOOLEAN                                  ReceiveContextHandle;
  BOOLEAN                                  DisableNTLMCredentialCaching;
  UCHAR                                    ExFlags;
  HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
  HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS  BasicParams;
} HTTP_SERVER_AUTHENTICATION_INFO, *PHTTP_SERVER_AUTHENTICATION_INFO;

成員

Flags

指定屬性是否存在 的 HTTP_PROPERTY_FLAGS 結構。

AuthSchemes

支援的驗證配置。 這可以是下列其中一或多個：

驗證配置 意義
HTTP_AUTH_ENABLE_BASIC
 已啟用基本驗證。
HTTP_AUTH_ENABLE_DIGEST
 已啟用摘要式驗證。
HTTP_AUTH_ENABLE_NTLM
 已啟用 NTLM 驗證。
HTTP_AUTH_ENABLE_NEGOTIATE
 已啟用交涉驗證。
HTTP_AUTH_ENABLE_KERBEROS
 已啟用 Kerberos 驗證。
HTTP_AUTH_ENABLE_ALL
 啟用所有類型的驗證。

ReceiveMutualAuth

布林值，指出如果 為 True，用戶端應用程式會收到伺服器認證，以便與已驗證的要求相互驗證。 如果 為 False，用戶端應用程式就不會收到認證。

請注意，此選項會針對相關聯的要求佇列所提供的所有要求進行設定。

ReceiveContextHandle

布林值，指出完成的用戶端內容會序列化並傳遞至具有要求的應用程式。如果 為 True，則為布林值。 如果 為 False，應用程式就不會收到內容。 此控制碼可用來查詢內容屬性。

DisableNTLMCredentialCaching

布林值，指出不會快取 NTLM 認證，如果 為 True，則為布林值。 如果 為 False，則會保留預設行為。

根據預設，如果要求不是來自 Proxy，HTTP 會快取 NTLM 配置 (KA) 連線的用戶端內容。

ExFlags

選擇性驗證旗標。 可以是下列其中一或多個可能的值：

值 意義
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING
 如果設定，則會快取 Kerberos 驗證認證。 Kerberos 或 Negotiate 驗證必須由 AuthSchemes啟用。
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL
 如果設定，HTTP Server API 會擷取呼叫端的認證，並將它們用於 Kerberos 或交涉驗證。 Kerberos 或 Negotiate 驗證必須由 AuthSchemes啟用。

DigestParams

提供摘要挑戰領域和領域 之HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS 結構。

BasicParams

提供基本挑戰領域 之HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS 結構。

備註

如果已在相關聯的 URL 群組上設定驗證， HTTP_SERVER_AUTHENTICATION_INFO 結構就會包含在 HTTP 要求中。 從用戶端接收的原始 HTTP 驗證標頭一律包含在 HTTP 要求中，不論驗證狀態為何。

需求

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

另請參閱

HTTP 伺服器 API 2.0 版結構

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty