HttpRemoveUrlFromUrlGroup 함수(http.h)

아티클
03/05/2024

HttpRemoveUrlFromUrlGroup 함수는 URL 그룹 ID로 식별된 그룹에서 지정된 URL을 제거합니다. 이 함수는 그룹에서 URL을 하나 또는 모두 제거합니다.

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

구문

HTTPAPI_LINKAGE ULONG HttpRemoveUrlFromUrlGroup(
  [in] HTTP_URL_GROUP_ID UrlGroupId,
  [in] PCWSTR            pFullyQualifiedUrl,
  [in] ULONG             Flags
);

매개 변수

[in] UrlGroupId

pFullyQualifiedUrl에 지정된 URL이 제거되는 URL 그룹의 ID입니다.

[in] pFullyQualifiedUrl

제거할 URL을 식별하는 적절한 형식의 UrlPrefix String 이 포함된 유니코드 문자열에 대한 포인터입니다.

flags 매개 변수에 HTTP_URL_FLAG_REMOVE_ALL 전달되면 UrlGroupId에서 식별된 URL 그룹에 대한 모든 기존 URL 등록이 그룹에서 제거됩니다. 이 경우 pFullyQualifiedUrl 은 NULL이어야 합니다.

[in] Flags

제거된 URL을 한정하는 URL 플래그입니다. 다음 플래그 중 하나일 수 있습니다.

URL 플래그	의미
HTTP_URL_FLAG_REMOVE_ALL	현재 URL 그룹에 등록된 모든 URL을 제거합니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	URL 그룹이 없습니다. Flags 매개 변수에는 잘못된 플래그 조합이 포함되어 있습니다. HTTP_URL_FLAG_REMOVE_ALL 플래그가 설정되었고 pFullyQualifiedUrl 매개 변수가 NULL로 설정되지 않았습니다. 애플리케이션에는 그룹에서 URL을 제거할 수 있는 권한이 없습니다. URL 그룹을 만든 애플리케이션만 URL을 제거할 수 있습니다.
ERROR_ACCESS_DENIED	호출 프로세스에는 URL 등록을 취소할 수 있는 권한이 없습니다.
ERROR_FILE_NOT_FOUND	지정된 URL이 URL 그룹에 등록되지 않았습니다.

값

의미

ERROR_INVALID_PARAMETER

URL 그룹이 없습니다.

Flags 매개 변수에는 잘못된 플래그 조합이 포함되어 있습니다.

HTTP_URL_FLAG_REMOVE_ALL 플래그가 설정되었고 pFullyQualifiedUrl 매개 변수가 NULL로 설정되지 않았습니다.

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

ERROR_ACCESS_DENIED

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

ERROR_FILE_NOT_FOUND

지정된 URL이 URL 그룹에 등록되지 않았습니다.

설명

HTTP Server API는 버전 1.0 URL 등록을 사용하여 기존 애플리케이션을 지원합니다. 그러나 HTTP Server API를 사용한 새 개발에서는 HttpRemoveUrlFromUrlGroup을 사용해야 합니다. HttpRemoveUrl을 사용하지 마세요.

애플리케이션은 URL이 더 이상 필요하지 않은 경우 HttpAddUrlToUrlGroup에 의해 그룹에 추가된 URL을 제거해야 합니다.

요구 사항

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