• Article

ReportingService2005.ValidateExtensionSettings Method

Validates Reporting Services extension settings.

Namespace:  ReportService2005
Assembly:  ReportService2005 (in ReportService2005.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()
'Usage
Dim instance As ReportingService2005
Dim Extension As String
Dim ParameterValues As ParameterValueOrFieldReference()
Dim returnValue As ExtensionParameter()

returnValue = instance.ValidateExtensionSettings(Extension, _
    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 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
)

[<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)>]
member ValidateExtensionSettings : 
        Extension:string * 
        ParameterValues:ParameterValueOrFieldReference[] -> ExtensionParameter[] 

public function ValidateExtensionSettings(
    Extension : String, 
    ParameterValues : ParameterValueOrFieldReference[]
) : ExtensionParameter[]

Parameters

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

Return Value

Type: array<ReportService2005.ExtensionParameter[]
An array of ExtensionParameter objects that contain validated extension settings and any required settings that were not specified.

Remarks

The table below shows header and permissions information on this operation.

SOAP Headers

(Out) ServerInfoHeaderValue

Required Permissions

None

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.