HttpAddUrlToUrlGroup 함수(http.h)

아티클
08/24/2023

HttpAddUrlToUrlGroup 함수는 URL 그룹 ID로 식별된 URL 그룹에 지정된 URL을 추가합니다.

이 함수는 HTTP 버전 1.0 HttpAddUrl 함수를 대체합니다.

구문

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

매개 변수

[in] UrlGroupId

지정된 URL에 대한 요청이 라우팅되는 URL 그룹의 그룹 ID입니다. URL 그룹은 HttpCreateUrlGroup 함수에 의해 만들어집니다.

[in] pFullyQualifiedUrl

등록할 URL을 식별하는 올바른 형식의 UrlPrefix String 이 포함된 유니코드 문자열에 대한 포인터입니다. 관리자 권한으로 실행하지 않는 경우 1024보다 큰 포트 번호를 지정합니다. 그렇지 않으면 ERROR_ACCESS_DENIED 오류가 발생할 수 있습니다.

[in, optional] UrlContext

이 호출에 등록된 URL과 연결된 컨텍스트입니다. URL 컨텍스트는 pFullyQualifiedUrl 매개 변수에 지정된 URL에 대해 수신된 모든 요청과 함께 HTTP_REQUEST 구조에서 반환됩니다.

[in] Reserved

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

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	UrlGroupId가 없습니다. Reserved 매개 변수가 0이 아닙니다. 애플리케이션에 그룹에 URL을 추가할 수 있는 권한이 없습니다. URL 그룹을 만든 애플리케이션만 URL을 추가할 수 있습니다.
ERROR_ACCESS_DENIED	호출 프로세스에는 URL을 등록할 수 있는 권한이 없습니다.
ERROR_ALREADY_EXISTS	지정된 URL이 기존 등록과 충돌합니다.

값

의미

ERROR_INVALID_PARAMETER

UrlGroupId가 없습니다.

Reserved 매개 변수가 0이 아닙니다.

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

ERROR_ACCESS_DENIED

호출 프로세스에는 URL을 등록할 수 있는 권한이 없습니다.

ERROR_ALREADY_EXISTS

지정된 URL이 기존 등록과 충돌합니다.

설명

HTTP Server API는 버전 1.0 URL 등록을 사용하여 기존 애플리케이션을 지원합니다. 그러나 HTTP Server API를 사용한 새로운 개발에서는 HttpAddUrlToUrlGroup을 사용해야 합니다. HttpAddUrl을 사용하면 안 됩니다.

애플리케이션은 HttpAddUrlToUrlGroup에 대한 반복 호출을 사용하여 URL 그룹에 여러 URL을 추가할 수 있습니다. 지정된 URL과 일치하는 요청은 URL 그룹과 연결된 요청 큐로 라우팅됩니다. HTTP Server API가 요청 URL을 등록된 URL과 일치하게 하는 방법에 대한 자세한 내용은 UrlPrefix 문자열을 참조하세요.

요구 사항

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