| title | IAppHostConfigLocation::AddConfigSection Method |
|---|---|
| ms.date | 10/07/2016 |
| description | The IAppHostConfigLocation::AddConfigSection Method adds a configuration section to the current configuration location. |
| ms.assetid | c26ddb6b-2166-3486-870f-fb5b0574feb1 |
Adds a configuration section to the current configuration location.
HRESULT AddConfigSection(
[in] BSTR bstrSectionName,
[out,
retval] IAppHostElement** ppAdminElement
); bstrSectionName
A BSTR that contains the name of the section to add.
ppAdminElement
A pointer to a pointer for an IAppHostElement interface.
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. |
Configuration locations enable the [!INCLUDEiisver] 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.
| Type | Description |
|---|---|
| Client | - IIS 7.0 on [!INCLUDEwinvista] - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on [!INCLUDEwinsrv2008] - 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 - [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100] |
| Header | Ahadmin.h |