HttpSetUrlGroupProperty 함수(http.h)

아티클
08/24/2023

HttpSetUrlGroupProperty 함수는 새 속성을 설정하거나 지정된 URL 그룹에서 기존 속성을 수정합니다.

구문

HTTPAPI_LINKAGE ULONG HttpSetUrlGroupProperty(
  [in] HTTP_URL_GROUP_ID    UrlGroupId,
  [in] HTTP_SERVER_PROPERTY Property,
  [in] PVOID                PropertyInformation,
  [in] ULONG                PropertyInformationLength
);

매개 변수

[in] UrlGroupId

속성이 설정된 URL 그룹의 ID입니다.

[in] Property

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

속성	의미
HttpServerAuthenticationProperty	기본, NTLM, 협상 및 다이제스트 인증 체계를 사용하여 URL 그룹에 대한 서버 쪽 인증을 사용하도록 설정합니다.
HttpServerExtendedAuthenticationProperty	Kerberos 인증 체계를 사용하여 URL 그룹에 대한 서버 쪽 인증을 사용하도록 설정합니다.
HttpServerQosProperty	이 값은 QosType이 HttpQosSettingTypeBandwidth 또는 HttpQosSettingTypeConnectionLimit로 설정된 제네릭 HTTP_QOS_SETTING_INFO 구조에 매핑됩니다. HttpQosSettingTypeBandwidth인 경우 URL 그룹에 대한 대역폭 제한을 수정하거나 설정합니다. HttpQosSettingTypeConnectionLimit인 경우 언제든지 URL 그룹에 대해 제공되는 최대 미해결 연결 수를 수정하거나 설정합니다.
HttpServerBindingProperty	요청 큐를 사용하여 URL 그룹 연결을 수정하거나 설정합니다.
HttpServerLoggingProperty	URL 그룹에 대한 로깅을 수정하거나 설정합니다.
HttpServerStateProperty	URL 그룹의 상태를 수정하거나 설정합니다. 상태를 사용하거나 사용하지 않도록 설정할 수 있습니다.
HttpServerTimeoutsProperty	URL 그룹에 대한 연결 제한 시간을 수정하거나 설정합니다.
HttpServerChannelBindProperty	CBT(채널 바인딩 토큰)를 사용하는 서버 쪽 인증을 사용하도록 설정합니다.

[in] PropertyInformation

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

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

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

[in] PropertyInformationLength

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

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	속성 매개 변수에 지정된 속성 형식은 URL 그룹에 대해 지원되지 않습니다. pPropertyInformation 매개 변수는 NULL입니다. PropertyInformationLength 매개 변수는 0입니다. UrlGroupId 매개 변수에 유효한 서버 세션이 없습니다. 애플리케이션에는 URL 그룹 속성을 설정할 수 있는 권한이 없습니다. URL 그룹을 만든 애플리케이션만 속성을 설정할 수 있습니다.

값

의미

ERROR_INVALID_PARAMETER

속성 매개 변수에 지정된 속성 형식은 URL 그룹에 대해 지원되지 않습니다.

pPropertyInformation 매개 변수는 NULL입니다.

PropertyInformationLength 매개 변수는 0입니다.

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

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

설명

URL 그룹을 만든 후에는 요청을 수신하려면 요청 큐와 연결되어야 합니다. URL 그룹을 요청 큐와 연결하기 위해 애플리케이션은 HttpServerBindingProperty 속성과 HttpSetUrlGroupProperty를 호출합니다. 이 속성을 설정하지 않으면 URL 그룹에 대한 일치하는 요청이 요청 큐에 배달되지 않고 HTTP Server API가 503 응답을 생성합니다.

요구 사항


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