IComSoapPublisher.CreateVirtualRoot Method

Definition

Namespace:

System.EnterpriseServices.Internal

Assembly:

System.EnterpriseServices.dll

Creates a SOAP-enabled COM+ application virtual root.

public:
 void CreateVirtualRoot(System::String ^ Operation, System::String ^ FullUrl, [Runtime::InteropServices::Out] System::String ^ % BaseUrl, [Runtime::InteropServices::Out] System::String ^ % VirtualRoot, [Runtime::InteropServices::Out] System::String ^ % PhysicalPath, [Runtime::InteropServices::Out] System::String ^ % Error);

public void CreateVirtualRoot (string Operation, string FullUrl, out string BaseUrl, out string VirtualRoot, out string PhysicalPath, out string Error);

abstract member CreateVirtualRoot : string * string * string * string * string * string -> unit

Public Sub CreateVirtualRoot (Operation As String, FullUrl As String, ByRef BaseUrl As String, ByRef VirtualRoot As String, ByRef PhysicalPath As String, ByRef Error As String)

Parameters

Operation

String

The operation to perform.

FullUrl

String

The complete URL address for the virtual root.

BaseUrl

String

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

VirtualRoot

String

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

PhysicalPath

String

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

Error

String

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

Exceptions

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 null.

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.

Remarks

It is recommended that CreateVirtualRootEx be used instead of CreateVirtualRoot.