共用方式為

HTTPQueryServiceConfiguration 函式 (http.h)

  • 發行項

HttpQueryServiceConfiguration 函式會擷取一或多個 HTTP Server API 組態記錄。

語法

HTTPAPI_LINKAGE ULONG HttpQueryServiceConfiguration(
  [in]                HANDLE                 ServiceHandle,
  [in]                HTTP_SERVICE_CONFIG_ID ConfigId,
  [in, optional]      PVOID                  pInput,
  [in, optional]      ULONG                  InputLength,
  [in, out, optional] PVOID                  pOutput,
  [in, optional]      ULONG                  OutputLength,
  [out, optional]     PULONG                 pReturnLength,
  [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 集中式證書存儲的 SSL 組態， (CCS) 記錄。 埠是由您傳遞至 pInputConfigInfo 參數之 HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 結構的 KeyDesc 成員所指定。

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

[in, optional] pInput

結構指標，其內容會進一步定義查詢和下表中 與 ConfigId 相互關聯的類型。

ConfigId 值 意義
HttpServiceConfigIPListenList
 沒有輸入數據;設定為 NULL。
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_QUERY 結構。
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_QUERY 結構。
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_KEY 結構。

Windows Vista 和更新版本： 支援這個結構。
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_QUERY 結構。

Windows 8 及更新版本：支援此結構。
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 結構。

Windows 8 及更新版本：支援此結構。
 

如需詳細資訊，請參閱適當的查詢結構。

[in, optional] InputLength

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

[in, out, optional] pOutput

傳回查詢結果之緩衝區的指標。 此緩衝區的類型會與 ConfigId 相互關聯。

ConfigId 值 意義
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY 結構。
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET 結構。
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET 結構。
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_PARAM 數據類型。

Windows Vista 和更新版本： 支援這個結構。
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET 結構。

Windows 8 及更新版本：支援此結構。
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET 結構。

Windows 8 及更新版本：支援此結構。

[in, optional] OutputLength

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

[out, optional] pReturnLength

變數的指標，接收要寫入輸出緩衝區中的位元元組數目。 如果輸出緩衝區太小，呼叫會失敗，且傳回值為 ERROR_INSUFFICIENT_BUFFER。 pReturnLength 所指向的值可用來判斷緩衝區成功所需的最小長度。

[in] pOverlapped

保留給異步操作，且必須設定為 NULL。

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 其中一個參數無效。
ERROR_INSUFFICIENT_BUFFER
 pOutputConfigInfo 所指向的緩衝區太小，無法接收輸出數據。 再次呼叫函式，且緩衝區的大小至少與 結束時 pReturnLength 所指向的大小相同。
ERROR_MORE_DATA
 pOutputConfigInfo 所指向的緩衝區太小，無法接收輸出數據。 再次呼叫函式，且緩衝區的大小至少與 結束時 pReturnLength 所指向的大小相同。
ERROR_NO_MORE_ITEMS
 沒有更多項目可傳回符合指定準則的專案。
其他
 WinError.h 中定義的 系統錯誤碼 。

規格需求

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

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration