IAppHostConfigLocation::AddConfigSection Method

Article
06/14/2022

Adds a configuration section to the current configuration location.

Syntax

HRESULT AddConfigSection(  
   [in] BSTR bstrSectionName,  
   [out,  
   retval] IAppHostElement** ppAdminElement  
);

Parameters

bstrSectionName
A BSTR that contains the name of the section to add.

ppAdminElement
A pointer to a pointer for an IAppHostElement interface.

Return Value

An HRESULT. Possible values include, but are not limited to, those in the following table.

Value	Description
S_OK	Indicates that the operation was successful.
ERROR_ALREADY_EXISTS	Indicates that the configuration section already exists
ERROR_INVALID_DATA	Indicates that the data is invalid.

Remarks

Configuration locations enable the IIS 7 configuration system to customize the configuration based on the path of the content that the location represents. For instance, you may want to configure the system.webServer/asp configuration section for each Web site. In that case, you would remove the configuration section from the default location in the ApplicationHost.config configuration system file. To enable the configuration section for a Web site, you would add the configuration section under the Web site's configuration location.

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Ahadmin.h

Share via