HttpSetServerSessionProperty 함수(http.h)

  • 아티클

HttpSetServerSessionProperty 함수는 새 서버 세션 속성을 설정하거나 지정된 서버 세션에서 기존 속성을 수정합니다.

구문

HTTPAPI_LINKAGE ULONG HttpSetServerSessionProperty(
  [in] HTTP_SERVER_SESSION_ID ServerSessionId,
  [in] HTTP_SERVER_PROPERTY   Property,
  [in] PVOID                  PropertyInformation,
  [in] ULONG                  PropertyInformationLength
);

매개 변수

[in] ServerSessionId

속성이 설정된 서버 세션입니다.

[in] Property

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

속성 의미
HttpServerStateProperty
 서버 세션의 상태를 수정하거나 설정합니다. 상태를 사용하거나 사용하지 않도록 설정할 수 있습니다. 기본 상태가 사용하도록 설정되어 있습니다.
HttpServerTimeoutsProperty
 서버 세션 연결 제한 시간을 수정하거나 설정합니다.
HttpServerQosProperty
 서버 세션에 대한 대역폭 제한을 수정하거나 설정합니다. 기본적으로 HTTP 서버 API는 대역폭을 제한하지 않습니다.
참고 이 값은 QosType이 HttpQosSettingTypeBandwidth로 설정된 제네릭 HTTP_QOS_SETTING_INFO 구조체에 매핑됩니다.
 
HttpServerLoggingProperty
 서버 세션에 대한 로깅을 사용하거나 사용하지 않도록 설정합니다. 이 속성은 중앙 집중식 W3C 및 중앙 집중식 이진 로깅만 설정합니다. 기본적으로 로깅은 사용하도록 설정되지 않습니다.
HttpServerAuthenticationProperty
 기본, NTLM, 협상 및 다이제스트 인증 체계에 커널 모드 서버 쪽 인증을 사용하도록 설정합니다.
HttpServerExtendedAuthenticationProperty
 Kerberos 인증 체계에 커널 모드 서버 쪽 인증을 사용하도록 설정합니다.
HttpServerChannelBindProperty
CBT(채널 바인딩 토큰)를 사용하는 서버 쪽 인증을 사용하도록 설정합니다.

[in] PropertyInformation

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

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

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

[in] PropertyInformationLength

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

반환 값

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

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

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

pPropertyInformation 매개 변수는 NULL입니다.

PropertyInformationLength 매개 변수는 0입니다.

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

애플리케이션에는 서버 세션 속성을 설정할 수 있는 권한이 없습니다. 서버 세션을 만든 애플리케이션만 속성을 설정할 수 있습니다.

설명

서버 세션은 해당 세션 아래에 생성된 모든 URL 그룹에 적용되는 구성 데이터에 대한 최상위 구성 컨테이너입니다. 서버 세션은 HttpCreateServerSession을 사용하여 만들어집니다.

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

요구 사항

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

추가 정보

HTTP 서버 API 버전 2.0 함수

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty