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 值 | 意義 |
---|---|
|
從 IP 接聽清單中刪除指定的 IP 位址。 |
|
刪除指定的 SSL 憑證記錄。 |
|
刪除指定的 URL 保留記錄。 |
|
刪除指定的連線逾時。
Windows Vista 和更新版本: 支援此列舉。 |
|
刪除指定的 SSL 伺服器名稱指示, (SNI) 憑證記錄。
Windows 8 和更新版本: 支援這個列舉值。 |
|
刪除 SSL 憑證記錄,指定如果埠收到傳輸層安全性 (TLS) 交握,則 Http.sys 應參閱集中式憑證存放區 (CCS) 存放區來尋找憑證。 埠是由您傳遞至pConfigInformation參數之 HTTP_SERVICE_CONFIG_SSL_CCS_SET結構的KeyDesc成員所指定。
Windows 8 和更新版本: 支援這個列舉值。 |
[in] pConfigInformation
緩衝區的指標,其中包含 ConfigId 參數中指定的組態類型所需的資料。
ConfigId 值 | 意義 |
---|---|
|
|
|
|
|
|
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY 結構。 Windows Vista 和更新版本: 支援這個結構。 |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET 結構。 當查詢 SSL 中央憑證存放區並使用萬用字元系結,並使用一般 SNI 的主機名稱時,主機名稱將會是 「*」。 Windows 8 和更新版本: 支援這個結構。 |
|
HTTP_SERVICE_CONFIG_SSL_CCS_SET 結構。 Windows 8 和更新版本: 支援這個結構。 |
[in] ConfigInformationLength
pConfigInformation緩衝區的大小,以位元組為單位。
[in] pOverlapped
保留給未來的非同步作業。 此參數必須設定為 Null。
傳回值
如果函式成功,函式會傳回NO_ERROR。
如果函式失敗,它會傳回下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
其中一個參數無效。 |
|
WinError.h 中定義的 系統錯誤碼 。 |
需求
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | HTTP.h |
程式庫 | Httpapi.lib |
Dll | Httpapi.dll |