ReportingService2005.ValidateExtensionSettings Method

Article
12/03/2008

Validates Reporting Services extension settings.

Namespace: Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005
Assembly: ReportService2005 (in reportingservice2005.dll)

Syntax

'Declaration
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction:=SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ValidateExtensionSettings", RequestNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
Public Function ValidateExtensionSettings ( _
    Extension As String, _
    ParameterValues As ParameterValueOrFieldReference() _
) As ExtensionParameter()

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out)] 
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ValidateExtensionSettings", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
public ExtensionParameter[] ValidateExtensionSettings (
    string Extension,
    ParameterValueOrFieldReference[] ParameterValues
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction=SoapHeaderDirection::Out)] 
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ValidateExtensionSettings", RequestNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse::Literal, ParameterStyle=SoapParameterStyle::Wrapped)] 
public:
array<ExtensionParameter^>^ ValidateExtensionSettings (
    String^ Extension, 
    array<ParameterValueOrFieldReference^>^ ParameterValues
)

/** @attribute SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) */ 
/** @attribute SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ValidateExtensionSettings", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) */ 
public ExtensionParameter[] ValidateExtensionSettings (
    String Extension, 
    ParameterValueOrFieldReference[] ParameterValues
)

SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) 
SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ValidateExtensionSettings", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) 
public function ValidateExtensionSettings (
    Extension : String, 
    ParameterValues : ParameterValueOrFieldReference[]
) : ExtensionParameter[]

Parameters

Extension
The name of the extension as it appears in the report server configuration file. Valid values are Report Server Email and Report Server FileShare.

ParameterValues
An array of ParameterValueOrFieldReference objects representing the settings to validate for the extension.

Return Value

An array of ExtensionParameter objects that contain validated extension settings and any required settings that were not specified.

Remarks

The ExtensionParameter objects that are returned by the ValidateExtensionSettings method contain the following items:

All valid setting values specified in the ParameterValues parameter
Settings with values that are not valid contain an error message (Error property of the ExtensionParameter class)
The names of all required settings that were not specified in the ParameterValues parameter with a Required property of the ExtensionParameter class set to a value of true.

Note

Currently, the ValidateExtensionSettings method supports delivery extensions. Other extensions are not yet supported by this method.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms