共用方式為

HTTPSetServiceConfiguration 函式 (http.h)

  • 發行項

HttpSetServiceConfiguration 函式會建立並設定 HTTP Server API 組態存放區的組態記錄。 如果指定的記錄已經存在，則呼叫會失敗。 若要變更指定的組態記錄，請將其刪除，然後使用不同的值重新建立。

語法

HTTPAPI_LINKAGE ULONG HttpSetServiceConfiguration(
  [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接聽清單中的記錄。
HttpServiceConfigsSLCertInfo
 設定指定的 SSL 憑證記錄。
HttpServiceConfigUrlAclInfo
 設定 URL 保留記錄。
HttpServiceConfigTimeout
 設定指定的 HTTP 伺服器 API 寬連線逾時。

Windows Vista 和更新版本： 支援這個列舉值。
HttpServiceConfigSslSniCertInfo
 設定指定的 SSL 伺服器名稱指示 (SNI) 憑證記錄。

Windows 8 及更新版本：支援此列舉值。
HttpServiceConfigSslCcsCertInfo
 設定 SSL 憑證記錄，指定 Http.sys 如果埠收到傳輸層安全性 (TLS) 交握，請查閱集中式證書存儲 (CCS) 存放區來尋找憑證。 埠是由您傳遞給 pConfigInformation 參數之 HTTP_SERVICE_CONFIG_SSL_CCS_SET 結構的 KeyDesc 成員所指定。

Windows 8 及更新版本：支援此列舉值。

[in] pConfigInformation

緩衝區的指標，其中包含要設定之記錄類型的適當數據。

ConfigId 值 意義
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM 結構。
HttpServiceConfigsSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET 結構。
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET 結構。
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_SET 結構。

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_ALREADY_EXISTS
 指定的記錄已經存在，而且必須刪除，才能重新設定其值。
ERROR_INSUFFICIENT_BUFFER
 ConfigInformationLength 參數中指定的緩衝區大小不足。
ERROR_INVALID_HANDLE
 ServiceHandle 參數無效。
ERROR_INVALID_PARAMETER
 提供的一或多個參數格式為無法使用。
ERROR_NO_SUCH_LOGON_SESSION
 使用的 SSL 憑證無效。 只有在使用 HttpServiceConfigSSLCertInfo 參數時，才會發生此情況。
其他
 WinError.h 中定義的 系統錯誤碼 。

備註

使用 HttpSetServiceConfiguration 設定的組態參數會套用至電腦上的所有 HTTP 伺服器 API 應用程式，並在 HTTP 伺服器 API 關閉或電腦重新啟動時保存。

規格需求

需求 值
最低支援的用戶端 具有 SP2 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 http.h
程式庫 Httpapi.lib
Dll Httpapi.dll

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration