共用方式為


HTTPDeleteServiceConfiguration 函式 (HTTP.h)

HttpDeleteServiceConfiguration函式會從 HTTP 伺服器 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 意義
HttpServiceConfigIPListenList
從 IP 接聽清單中刪除指定的 IP 位址。
HttpServiceConfigSSLCertInfo
刪除指定的 SSL 憑證記錄。
HttpServiceConfigUrlAclInfo
刪除指定的 URL 保留記錄。
HttpServiceConfigTimeout
刪除指定的連線逾時。

Windows Vista 和更新版本: 支援此列舉。

HttpServiceConfigSslSniCertInfo
刪除指定的 SSL 伺服器名稱指示, (SNI) 憑證記錄。

Windows 8 和更新版本: 支援這個列舉值。

HttpServiceConfigSslCcsCertInfo
刪除 SSL 憑證記錄,指定如果埠收到傳輸層安全性 (TLS) 交握,則 Http.sys 應參閱集中式憑證存放區 (CCS) 存放區來尋找憑證。 埠是由您傳遞至pConfigInformation參數之 HTTP_SERVICE_CONFIG_SSL_CCS_SET結構的KeyDesc成員所指定。

Windows 8 和更新版本: 支援這個列舉值。

[in] pConfigInformation

緩衝區的指標,其中包含 ConfigId 參數中指定的組態類型所需的資料。

ConfigId 意義
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。

如果函式失敗,它會傳回下列其中一個錯誤碼。

意義
ERROR_INVALID_PARAMETER
其中一個參數無效。
其他
WinError.h 中定義的 系統錯誤碼

需求

   
最低支援的用戶端 Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 HTTP.h
程式庫 Httpapi.lib
Dll Httpapi.dll

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration