HttpQueryUrlGroupProperty 함수(http.h)

아티클
08/24/2023

HttpQueryUrlGroupProperty 함수는 지정된 URL 그룹의 속성을 쿼리합니다.

구문

HTTPAPI_LINKAGE ULONG HttpQueryUrlGroupProperty(
  [in]            HTTP_URL_GROUP_ID    UrlGroupId,
  [in]            HTTP_SERVER_PROPERTY Property,
  [out]           PVOID                PropertyInformation,
  [in]            ULONG                PropertyInformationLength,
  [out, optional] PULONG               ReturnLength
);

매개 변수

[in] UrlGroupId

속성 설정이 반환되는 URL 그룹의 ID입니다.

[in] Property

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

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

[out] PropertyInformation

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

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

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

[in] PropertyInformationLength

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

[out, optional] ReturnLength

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

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

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	속성 매개 변수에 지정된 속성 형식은 URL 그룹에 대해 지원되지 않습니다. UrlGroupId 매개 변수는 유효한 서버 URL 그룹을 식별하지 않습니다. pPropertyInformation 매개 변수는 NULL입니다. PropertyInformationLength 매개 변수는 0입니다. 애플리케이션에는 URL 그룹 속성을 쿼리할 수 있는 권한이 없습니다. URL 그룹을 만든 애플리케이션만 속성을 쿼리할 수 있습니다.
ERROR_MORE_DATA	pPropertyInformation 매개 변수가 가리키는 버퍼의 크기(바이트)가 너무 작아 속성 정보를 수신할 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다.

값

의미

ERROR_INVALID_PARAMETER

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

UrlGroupId 매개 변수는 유효한 서버 URL 그룹을 식별하지 않습니다.

pPropertyInformation 매개 변수는 NULL입니다.

PropertyInformationLength 매개 변수는 0입니다.

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

ERROR_MORE_DATA

pPropertyInformation 매개 변수가 가리키는 버퍼의 크기(바이트)가 너무 작아 속성 정보를 수신할 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다.

설명

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

요구 사항


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