IComSoapPublisher.CreateVirtualRoot Method

Definition

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

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.

FullUrl is null.

An error is encountered when resolving the local host name.

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.

Applies to