HttpUpdateServiceConfiguration 函式 (http.h)

發行項
02/29/2024

匯報服務組態參數，指定 HTTP Server API 組態存放區內組態記錄中的傳輸層安全性 (TLS) 憑證。

語法

HTTPAPI_LINKAGE ULONG HttpUpdateServiceConfiguration(
  [in] HANDLE                 Handle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  ConfigInfo,
  [in] ULONG                  ConfigInfoLength,
  [in] LPOVERLAPPED           Overlapped
);

參數

[in] Handle

保留且必須是 NULL。

[in] ConfigId

要更新的組態記錄類型。此參數可以是下列 HTTP_SERVICE_CONFIG_ID列舉值之一。

ConfigId 值	意義
HttpServiceConfigSSLCertInfo	匯報指定的 SSL 憑證記錄。
HttpServiceConfigSslSniCertInfo	匯報指定的 SSL 伺服器名稱指示 (SNI) 憑證記錄。
HttpServiceConfigSslCcsCertInfo	匯報 SSL 憑證記錄，指定 Http.sys 應該參閱集中式證書存儲 (CCS) 存放區，以在埠收到 TLS 交握時尋找憑證。埠是由您傳遞至 pConfigInfo 參數之 HTTP_SERVICE_CONFIG_SSL_CCS_SET 結構的 KeyDesc 成員所指定。

[in] ConfigInfo

緩衝區的指標，其中包含要更新之記錄類型的適當數據。下表顯示緩衝區針對 ConfigId 參數的不同可能值所包含的數據類型。

ConfigId 值	pConfigInfo 緩衝區中的數據類型
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET 結構。
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET 結構。當查詢 SSL 中央證書存儲並使用通配符系結，並使用一般 SNI 的主機名時，主機名將會是 “*”。
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET 結構。這個結構可用來在指定的埠上新增CCS存放區，以及刪除、擷取或更新現有的SSL CCS記錄。

[in] ConfigInfoLength

ConfigInfo 緩衝區的大小，以位元組為單位。

[in] Overlapped

保留且必須是 NULL。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
ERROR_FILE_NOT_FOUND	指定的記錄不存在。
ERROR_INSUFFICIENT_BUFFER	ConfigInfoLength 參數中指定的緩衝區大小不足。
ERROR_INVALID_HANDLE	ServiceHandle 參數無效。
ERROR_INVALID_PARAMETER	一或多個提供的參數格式為無法使用。
ERROR_NO_SUCH_LOGON_SESSION	使用的 SSL 憑證無效。只有在使用 HttpServiceConfigSSLCertInfo 參數時，才會發生此情況。
其他	WinError.h 中定義的系統錯誤碼。

備註

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

規格需求

需求	值
最低支援的用戶端	Windows 10 版本 1703 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	http.h
程式庫	Httpapi.lib
Dll	Httpapi.dll