This topic has not yet been rated - Rate this topic

RemoveURL Method (WMI MSReportServer_ConfigurationSetting)

SQL Server 2012

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\<InstanceName>\v11\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)

Reference

MSReportServer_ConfigurationSetting Members

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD