RemoveURL Method (WMI MSReportServer_ConfigurationSetting)

Removes a URL reserved for the report server. If there are multiple URLs that need to be removed, this must be done 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 was not successful.

Remarks

UrlString does not 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 an SSL Certificate was provisioned by Reporting Services and no other URLs need it, it is removed.

This method causes all non-configuration app domains to hard recycle and stop during this operation; app domains are restarted after this operation complete.

Requirements

Namespace: root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v10\Admin

Platform: Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional with Service Pack 2 (SP2) or Service Pack 1 (SP1); or Windows 2000 (all versions)