HttpCreateUrlGroup 함수(http.h)

아티클
08/24/2023

HttpCreateUrlGroup 함수는 지정된 서버 세션 아래에 URL 그룹을 만듭니다.

구문

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

매개 변수

[in] ServerSessionId

URL 그룹을 만드는 서버 세션의 식별자입니다.

[out] pUrlGroupId

URL 그룹의 ID를 받는 변수에 대한 포인터입니다.

[in] Reserved

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

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	ServerSessionId 매개 변수는 존재하지 않는 서버 세션을 나타냅니다. pUrlGroupId 매개 변수는 null입니다. Reserved 매개 변수는 0이 아닙니다.

값

의미

ERROR_INVALID_PARAMETER

ServerSessionId 매개 변수는 존재하지 않는 서버 세션을 나타냅니다.

pUrlGroupId 매개 변수는 null입니다.

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

설명

URL 그룹은 URL 집합에 대한 구성 컨테이너입니다. 서버 세션 아래에 만들어지고 서버 세션의 구성 설정을 상속합니다. URL 그룹에 구성 매개 변수가 설정되면 서버 세션의 구성 집합을 재정의합니다. URL 그룹에 대한 설정 구성에 대한 자세한 내용은 HttpSetUrlGroupProperty를 참조하세요.

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

요청 큐와 URL 그룹 연결이 동적입니다. 서버 세션 또는 URL 그룹이 삭제될 때까지 서버 세션과의 연결을 변경할 수 없습니다. 서버 세션이 삭제되면 연결된 모든 URL 그룹도 자동으로 닫힙니다.

URL 그룹은 처음에 빈 그룹으로 만들어집니다. HTTPAddUrlToUrlGroup을 호출하여 그룹에 URL을 추가해야 합니다.

애플리케이션은 다음과 같은 이유로 여러 URL 그룹을 만들 수 있습니다.

수신 대기 중인 URL 이름 공간의 여러 부분에 대해 고유한 구성을 설정하려면
수신 대기 중인 URL 이름 공간의 여러 부분에 대해 별도의 요청 큐를 설정하려면

애플리케이션은 URL을 가능한 한 그룹으로 결합해야 합니다. 그렇지 않으면 성능이 저하되고 시스템의 메모리 사용량이 증가하면 확장성에 영향을 줍니다.

HTTP Server API는 URL 그룹에서 비동기 I/O를 지원하지 않습니다.

URL 그룹이 더 이상 필요하지 않거나 애플리케이션이 종료되기 전에 HttpCloseUrlGroup을 호출하여 URL 그룹을 삭제해야 합니다.

URL 그룹은 URL 그룹이 만들어지는 서버 세션과 동일한 버전으로 만들어집니다.

요구 사항


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