iapphostconfigmanager-getconfigfile-method.md

title	IAppHostConfigManager::GetConfigFile Method
description	Learn how the GetConfigFile method gets a configuration file that is represented by the requested configuration path.
ms.date	10/07/2016
ms.assetid	addd9da3-1dc3-a705-9f0f-95ffa02025de

IAppHostConfigManager::GetConfigFile Method

Gets a configuration file that is represented by the requested configuration path.

Syntax

HRESULT GetConfigFile(  
   [in,  
   string] BSTR bstrConfigPath,  
   [out,  
   retval] IAppHostConfigFile** ppConfigFile  
);  

Parameters

bstrConfigPath
A BSTR that contains the configuration file path being requested.

ppConfigFile
A pointer to a pointer for an IAppHostConfigFile 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.

Remarks

This method provides access to the physical configuration files represented by a configuration system path. For example, passing "MACHINE/WEBROOT/APPHOST" to the bstrConfigPath parameter would return an IAppHostConfigFile instance in the ppConfigFile parameter that represents the ApplicationHost.config file.

Example

The following code example obtains a configuration file, adds a new section group and a new section, sets properties on the new section, and then commits the changes to the configuration system.

[!code-cppIAppHostAdminLibrary#7]

Requirements

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

See Also

IAppHostConfigManager Interface