The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WebConfigurationManager::OpenMachineConfiguration Method (String^, String^, IntPtr)

.NET Framework (current version)

Other Versions

Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations.

Namespace: System.Web.Configuration
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public:
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
static Configuration^ OpenMachineConfiguration(
	String^ locationSubPath,
	String^ server,
	IntPtr userToken
)

Parameters

locationSubPath: Type: System::String^
The application path to which the configuration applies.

server: Type: System::String^
The fully qualified name of the server to return the configuration for.

userToken: Type: System::IntPtr
An account token to use.

Return Value

Type: System.Configuration::Configuration^

A Configuration object.

Exceptions

Exception	Condition
ArgumentException	Valid values were not supplied for the server or userToken parameters.
ConfigurationErrorsException	A valid configuration file could not be loaded.

Remarks

This method is used to access a configuration file using impersonation.

Note
The account token is usually retrieved from an instance of the WindowsIdentity class or through a call to unmanaged code, such as a call to the Win32 API LogonUser. For more information about calls to unmanaged code, see Consuming Unmanaged DLL Functions.