다음을 통해 공유


HttpAddUrlToUrlGroup 함수(http.h)

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이 기존 등록과 충돌합니다.

설명

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

추가 정보

HTTP 서버 API 버전 2.0 함수

HttpAddUrl

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

HttpSetUrlGroupProperty

UrlPrefix 문자열