HttpQueryServerSessionProperty 함수(http.h)

  • 아티클

HttpQueryServerSessionProperty 함수는 지정된 서버 세션에서 서버 속성을 쿼리합니다.

구문

HTTPAPI_LINKAGE ULONG HttpQueryServerSessionProperty(
  [in]            HTTP_SERVER_SESSION_ID ServerSessionId,
  [in]            HTTP_SERVER_PROPERTY   Property,
  [out]           PVOID                  PropertyInformation,
  [in]            ULONG                  PropertyInformationLength,
  [out, optional] PULONG                 ReturnLength
);

매개 변수

[in] ServerSessionId

속성 설정이 반환되는 서버 세션입니다.

[in] Property

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

속성 의미
HttpServerStateProperty
 서버 세션의 현재 상태를 쿼리합니다.
HttpServerTimeoutsProperty
 서버 세션 연결 제한 시간을 쿼리합니다.
HttpServerQosProperty
 서버 세션에 대한 대역폭 제한을 쿼리합니다. 기본적으로 HTTP Server API는 대역폭을 제한하지 않습니다.
HttpServerAuthenticationProperty
 기본, NTLM, 협상 및 다이제스트 인증 체계에 대한 커널 모드 서버 쪽 인증을 쿼리합니다.
HttpServerChannelBindProperty
 CBT(채널 바인딩 토큰) 속성을 쿼리합니다.

[out] PropertyInformation

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

pPropertyInformation 은 설정된 속성을 기반으로 다음 속성 데이터 구조 중 하나를 가리킵니다.

속성 구조체
HttpServerStateProperty HTTP_STATE_INFO
HttpServerQosProperty HTTP_QOS_SETTING_INFO
HttpServerTimeoutsProperty HTTP_TIMEOUT_LIMIT_INFO
HttpServerAuthenticationProperty HTTP_SERVER_AUTHENTICATION_INFO
HttpServerChannelBindProperty HTTP_CHANNEL_BIND_INFO

[in] PropertyInformationLength

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

[out, optional] ReturnLength

pPropertyInformation 버퍼에 반환된 숫자(바이트)입니다.

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

반환 값

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

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

값 의미
ERROR_INVALID_PARAMETER
 속성 매개 변수에 지정된 속성 형식은 서버 세션에서 지원되지 않습니다.

ServerSessionId 매개 변수에 유효한 서버 세션이 없습니다.

pPropertyInformation 매개 변수는 NULL입니다.

PropertyInformationLength 매개 변수는 0입니다.

애플리케이션에는 서버 세션 속성을 쿼리할 수 있는 권한이 없습니다. 서버 세션을 만든 애플리케이션만 속성을 쿼리할 수 있습니다.
ERROR_MORE_DATA
 pPropertyInformation 매개 변수가 가리키는 버퍼의 크기(바이트)가 너무 작아 속성 데이터를 수신할 수 없습니다. 종료 시 종료 시 pReturnLength 가 가리키는 크기만큼 버퍼가 있는 함수를 다시 호출합니다.

설명

HttpServerLoggingProperty 쿼리는 지원되지 않습니다.

pPropertyInformation 매개 변수는 쿼리되는 속성 형식의 구성 구조를 가리킵니다. PropertyInformationLength 매개 변수는 구성 구조의 크기(바이트)를 지정합니다. 예를 들어 HttpServerTimeoutsProperty 를 쿼리할 때 pPropertyInformation 매개 변수는 적어도 HTTP_TIMEOUT_LIMIT_INFO 구조체의 크기인 버퍼를 가리킵니다.

pPropertyInformation 매개 변수에서 HttpServerQosProperty 속성을 지정하려면 QosType을 HTTP_QOS_SETTING_INFO 구조체 내에서 HttpQosSettingTypeBandwidth로 설정하고 매개 변수에서 이 구조체에 대한 포인터를 전달합니다.

요구 사항

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

추가 정보

HTTP Server API 버전 2.0 함수

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty