ConfigurationSetting method - RemoveURL

Removes a URL reserved for the report server. If there are multiple URLs that need to be removed, you must do so one by one calling this API.

Syntax

Public Sub RemoveURL(ByVal Application As String, _  
    ByVal UrlString As String, ByVal Lcid As Int32, _  
    ByRef [Error] As String, ByRef HRESULT As Int32)  
public void RemoveURL(string Application, string UrlString, int Lcid,   
    out string Error, out int HRESULT);  

Parameters

Application
The name of application for which to remove the reservation.

URLString
The URL for the reservation.

lcid
The locale to use for the error messages returned.

Error
[out] The description of the error that occurred.

HRESULT
[out] Value indicating whether the call succeeded or failed.

Return value

Returns an HRESULT indicating success or failure of the method call. A value of 0 indicates that the method call was successful; an error code indicates the call wasn't successful.

Remarks

UrlString doesn't include the Virtual Directory name - the SetVirtualDirectory Method (WMI MSReportServer_ConfigurationSetting) method is provided for that purpose.

Before calling the ReserveURL method, you must supply a value for the VirtualDirectory configuration property for the Application parameter. Use the SetVirtualDirectory Method (WMI MSReportServer_ConfigurationSetting) method to set the VirtualDirectory property.

If you provision a TLS/SSL certificate by Reporting Services and no other URLs need it, the certificate is removed.

This method causes all nonconfiguration app domains to hard recycle and stop during this operation. App domains are restarted after this operation complete.

Requirements

Namespace: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

MSReportServer_ConfigurationSetting members