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

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

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

ExFlags

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

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

DigestParams

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

BasicParams

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

備註

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

規格需求

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

另請參閱

HTTP 伺服器 API 2.0 版結構

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty