HttpCloseUrlGroup function (http.h)

The HttpCloseUrlGroup function closes the URL Group identified by the URL Group ID. This call also removes all of the URLs that are associated with the URL Group.

Syntax

HTTPAPI_LINKAGE ULONG HttpCloseUrlGroup(
  [in] HTTP_URL_GROUP_ID UrlGroupId
);

Parameters

[in] UrlGroupId

The ID of the URL Group that is deleted.

Return value

If the function succeeds, it returns NO_ERROR.

If the function fails, it returns one of the following error codes.

Value Meaning
ERROR_INVALID_PARAMETER
The ID of the URL Group does not exist.

The application does not have permission to close the URL Group. Only the application that created the URL Group can close the group.

Remarks

Applications must call HttpCloseUrlGroup before calling HttpCloseServerSession to close the all URL Groups associated with the server session.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header http.h
Library Httpapi.lib
DLL Httpapi.dll

See also

HTTP Server API Version 2.0 Functions

HttpAddUrlToUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

HttpSetUrlGroupProperty