This topic has not yet been rated - Rate this topic

ReportingService2010::TestConnectForDataSourceDefinition Method

SQL Server 2008 R2

Other Versions

SQL Server 2012

Tests the connection for a data source. This method supports the direct testing of the data source.

Namespace: ReportService2010
Assembly: ReportService2010 (in ReportService2010.dll)

Syntax

C++

JScript

[SoapDocumentMethodAttribute(L"http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", RequestNamespace = L"http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
	ResponseNamespace = L"http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
	Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
bool TestConnectForDataSourceDefinition(
	DataSourceDefinition^ DataSourceDefinition, 
	String^ UserName, 
	String^ Password, 
	[OutAttribute] String^% ConnectError
)

Parameters

DataSourceDefinition: Type: ReportService2010::DataSourceDefinition
The data source definition that defines the connection to the data source.

UserName: Type: System::String
The user name to use to test the connection. UserName is used with data sources that prompt for credentials.

Password: Type: System::String
The password to use to test the connection. Password is used with data sources that prompt for credentials.

ConnectError: Type: System::String%
A detailed error message. The message is returned when the connection fails. The data source provider provides the detailed message.

Return Value

Type: System::Boolean
A Boolean the indicates whether the connection completed successfully.
A string that contains a detailed error message. The string is returned as the out parameter, ConnectError.

Remarks

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

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions

ExecuteReportDefinition (System)

SharePoint Mode Required Permissions

Needs the system property EnableLoadReportDefinition set to true

Permission to execute the report definition is required.