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

예약되어 있습니다. 0이어야 합니다.

[in] Reserved2

예약되어 있습니다. NULL이어야 합니다.

반환 값

함수가 성공하면 NO_ERROR 반환합니다.

함수가 실패하면 다음 오류 코드 중 하나를 반환합니다.

값	의미
ERROR_INVALID_PARAMETER	Reserved 매개 변수가 0이 아니거나 pReserved 매개 변수가 NULL이 아닙니다. Property 매개 변수에 지정된 속성 형식은 요청 큐에 대해 지원되지 않습니다. pPropertyInformation 매개 변수는 NULL입니다. PropertyInformationLength 매개 변수는 0입니다. 애플리케이션에는 요청 큐에 속성을 설정할 수 있는 권한이 없습니다. 요청 큐를 만든 애플리케이션만 속성을 설정할 수 있습니다.
ERROR_NOT_SUPPORTED	요청 큐에 대한 핸들은 HTTP 버전 1.0 핸들입니다. 속성 관리는 HTTP 버전 2.0 이상 요청 큐에서만 지원됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	http.h
라이브러리	Httpapi.lib
DLL	Httpapi.dll

추가 정보

HTTP 서버 API 버전 2.0 함수

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpShutdownRequestQueue