HttpQueryRequestQueueProperty 함수(http.h)

  • 아티클

HttpQueryRequestQueueProperty 함수는 지정된 핸들로 식별된 요청 큐의 속성을 쿼리합니다.

구문

HTTPAPI_LINKAGE ULONG HttpQueryRequestQueueProperty(
                  HANDLE               RequestQueueHandle,
  [in]            HTTP_SERVER_PROPERTY Property,
  [out]           PVOID                PropertyInformation,
  [in]            ULONG                PropertyInformationLength,
  [in]            ULONG                Reserved1,
  [out, optional] PULONG               ReturnLength,
  [in]            PVOID                Reserved2
);

매개 변수

RequestQueueHandle

[in] Property

설정된 속성 형식을 설명하는 HTTP_SERVER_PROPERTY 열거형의 멤버입니다. 다음 중 하나일 수 있습니다.

속성 의미
HttpServer503VerbosityProperty
 요청 큐에 대해 생성된 503개 응답의 현재 세부 정보 수준을 쿼리합니다.
HttpServerQueueLengthProperty
 요청 큐의 미해결 요청 수에 대한 제한을 쿼리합니다.
HttpServerStateProperty
 요청 큐의 현재 상태를 쿼리합니다. 상태는 활성 상태이거나 비활성 상태여야 합니다.

[out] PropertyInformation

속성 정보를 수신하는 버퍼에 대한 포인터입니다.

pPropertyInformation 은 설정된 속성에 따라 다음 속성 정보 값 중 하나를 가리킵니다.

속성 값
HttpServerStateProperty HTTP_ENABLED_STATE (열거형 멤버)
HttpServerQueueLengthProperty ULONG
HttpServer503VerbosityProperty HTTP_503_RESPONSE_VERBOSITY (열거형 멤버)

[in] PropertyInformationLength

pPropertyInformation 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.

[in] Reserved1

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

[out, optional] ReturnLength

NULL이 아닌 경우 pPropertyInformation 버퍼에 반환된 숫자(바이트)입니다.

출력 버퍼가 너무 작으면 반환 값이 ERROR_MORE_DATA 호출이 실패합니다. pReturnLength가 가리키는 값을 사용하여 호출이 성공하는 데 필요한 버퍼의 최소 길이를 결정할 수 있습니다.

[in] Reserved2

이 매개 변수는 예약되어 있으며 NULL이어야 합니다.

반환 값

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

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

값 의미
ERROR_INVALID_PARAMETER
 Reserved 매개 변수가 0이 아니거나 pReserved 매개 변수가 NULL이 아닙니다.

Property 매개 변수에 지정된 속성 형식은 요청 큐에서 지원되지 않습니다.

pPropertyInformation 매개 변수는 NULL입니다.

PropertyInformationLength 매개 변수는 0입니다.

애플리케이션에 요청 큐를 열 수 있는 권한이 없습니다.
ERROR_MORE_DATA
 pPropertyInformation 매개 변수가 가리키는 버퍼의 크기(바이트)가 너무 작아 속성 정보를 수신할 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다.
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

HttpSetRequestQueueProperty

HttpShutdownRequestQueue