HTTPSetRequestQueueProperty 函式 (http.h)

  • 發行項

HttpSetRequestQueueProperty 函式會設定新的屬性，或修改指定句柄所識別之要求佇列上的現有屬性。

語法

HTTPAPI_LINKAGE ULONG HttpSetRequestQueueProperty(
  [in] HANDLE               RequestQueueHandle,
  [in] HTTP_SERVER_PROPERTY Property,
  [in] PVOID                PropertyInformation,
  [in] ULONG                PropertyInformationLength,
  [in] ULONG                Reserved1,
  [in] PVOID                Reserved2
);

參數

[in] RequestQueueHandle

設定屬性之要求佇列的句柄。 系統會建立要求佇列，並透過呼叫 HttpCreateRequestQueue 函式所傳回的句柄。

[in] Property

描述所設定屬性類型 之HTTP_SERVER_PROPERTY 列舉的成員。 這必須是下列其中一項：

屬性 意義
HttpServer503VerbosityProperty
 修改或設定針對要求佇列產生的目前 503 回應詳細資訊層級。
HttpServerQueueLengthProperty
 修改或設定要求佇列中未處理要求數目的限制。
HttpServerStateProperty
 修改或設定要求佇列的狀態。 狀態必須是作用中或非作用中。

[in] PropertyInformation

緩衝區的指標，其中包含屬性資訊。

pPropertyInformation 會根據所設定的屬性，指向下列其中一個屬性信息類型。

屬性 組態類型
HttpServerStateProperty HTTP_ENABLED_STATE 列舉
HttpServerQueueLengthProperty ULONG
HttpServer503VerbosityProperty HTTP_503_RESPONSE_VERBOSITY 列舉

[in] PropertyInformationLength

pPropertyInformation 參數所指向之緩衝區的長度，以位元組為單位。

[in] Reserved1

保留的。 必須為零。

[in] Reserved2

保留的。 必須是 NULL。

傳回值

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

如果函式失敗，它會傳回下列其中一個錯誤碼。

值 意義
ERROR_INVALID_PARAMETER
 保留參數不是零，或 pReserved 參數不是 NULL。

要求佇列不支援 Property 參數中指定的屬性類型。

pPropertyInformation 參數為 NULL。

PropertyInformationLength 參數為零。

應用程式沒有在要求佇列上設定屬性的許可權。 只有建立要求佇列的應用程式可以設定屬性。
ERROR_NOT_SUPPORTED
 要求佇列的句柄是 HTTP 1.0 版句柄。 只有 HTTP 2.0 版或更新版本要求佇列才支援屬性管理。

規格需求

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

另請參閱

HTTP Server API 2.0 版函式

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpShutdownRequestQueue