Share via

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