共用方式為


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