IComSoapPublisher.CreateVirtualRoot Method

Creates a SOAP-enabled COM+ application virtual root.

Namespace: System.EnterpriseServices.Internal
Assembly: System.EnterpriseServices (in system.enterpriseservices.dll)

void CreateVirtualRoot (
	string Operation,
	string FullUrl,
	out string BaseUrl,
	out string VirtualRoot,
	out string PhysicalPath,
	out string Error
)
void CreateVirtualRoot (
	String Operation, 
	String FullUrl, 
	/** @attribute OutAttribute() */ /** @ref */ String BaseUrl, 
	/** @attribute OutAttribute() */ /** @ref */ String VirtualRoot, 
	/** @attribute OutAttribute() */ /** @ref */ String PhysicalPath, 
	/** @attribute OutAttribute() */ /** @ref */ String Error
)
JScript does not support passing value-type arguments by reference.

Parameters

Operation

The operation to perform.

FullUrl

The complete URL address for the virtual root.

BaseUrl

When this method returns, this parameter contains the base URL address.

VirtualRoot

When this method returns, this parameter contains the name of the virtual root.

PhysicalPath

When this method returns, this parameter contains the file path for the virtual root.

Error

When this method returns, this parameter contains an error message if a problem was encountered.

Exception typeCondition

SecurityException

A caller in the call chain does not have permission to access unmanaged code.

-or-

The caller does not have permission to access Domain Name System (DNS) information.

ArgumentNullException

FullUrl is a null reference (Nothing in Visual Basic).

SocketException

An error is encountered when resolving the local host name.

UriFormatException

FullUrl is empty.

-or-

The scheme specified in FullUrl is invalid.

-or-

FullUrl contains more than two consecutive slashes.

-or-

The password specified in FullUrl is invalid.

-or-

The host name specified in FullUrl is invalid.

-or-

The file name specified in FullUrl is invalid.

It is recommended that CreateVirtualRootEx be used instead of CreateVirtualRoot.

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show: