共用方式為

HttpDeleteServiceConfiguration 函數 （http.h）

HttpDeleteServiceConfiguration 函式會從 HTTP Server API 設定庫中逐筆刪除指定的資料，例如 IP 位址或 SSL 憑證。

語法

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

參數

[in] ServiceHandle

此參數是保留的，且必須為零。

[in] ConfigId

組態類型。 這個參數是 HTTP_SERVICE_CONFIG_ID 列舉中的一個值。

ConfigId 值 Meaning
HttpServiceConfigIPListenList
 從 IP 監聽清單中刪除指定的 IP 位址。
HttpServiceConfigSSLCertInfo
 刪除指定的 SSL 憑證紀錄。
HttpServiceConfigUrlAclInfo
 刪除指定的 URL 保留紀錄。
HttpServiceConfigTimeout
 刪除指定的連線逾時。

Windows Vista 及之後版本： 此列舉是有根據的。
HttpServiceConfigSslSniCertInfo
 刪除指定的 SSL 伺服器名稱指示（SNI）憑證記錄。

Windows 8 及以後版本： 此枚舉值是有支持的。
HttpServiceConfigSslCcsCertInfo
 刪除 SSL 憑證記錄，該紀錄規定若埠口收到傳輸層安全（TLS）握手，Http.sys 應查閱集中式憑證儲存庫（CCS）儲存以尋找憑證。 埠由你傳遞給 pConfigInformation 參數的 KeyDesc 成員指定，HTTP_SERVICE_CONFIG_SSL_CCS_SET結構中的角色。

Windows 8 及以後版本： 此枚舉值是有支持的。

[in] pConfigInformation

指標指向一個緩衝區，該緩衝區包含 ConfigId 參數中指定的配置類型所需的資料。

ConfigId 值 Meaning
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM 結構。
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET 結構。
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET 結構。
HttpServiceConfigTimeouts

HTTP_SERVICE_CONFIG_TIMEOUT_KEY 結構。

Windows Vista 及之後版本： 這個結構是有支撐的。
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET 結構。 當查詢 SSL 中央憑證儲存並使用通配碼綁定時，主機名稱會顯示為「*」，一般 SNI 則使用主機名稱。

Windows 8 及以後版本： 這個結構是有支撐的。
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET 結構。

Windows 8 及以後版本： 這個結構是有支撐的。

[in] ConfigInformationLength

pConfigInformation 緩衝區的大小（以位元組為單位）。

[in] pOverlapped

預留給未來非同步操作。 此參數必須設為 NULL。

返回值

如果函式成功，函數會返回 NO_ERROR。

若函式失敗，則會回傳以下其中一種錯誤碼。

價值觀 Meaning
ERROR_INVALID_PARAMETER
 其中一個參數是無效的。
其他
 系統 錯誤代碼 定義於 WinError.h.

需求

Requirement 價值觀
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
Header http.h
Library httpapi.lib
DLL Httpapi.dll

另請參閱

HTTP Server API 版本 1.0 功能

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateService組態

  • Last updated on