ReportingService2005.CreateReportHistorySnapshot Method

Generates a report history snapshot of a specified report.

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


<SoapHeaderAttribute("ServerInfoHeaderValue", Direction:=SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("", RequestNamespace:="", ResponseNamespace:="", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("BatchHeaderValue")> _
Public Function CreateReportHistorySnapshot ( _
    Report As String, _
    <OutAttribute> ByRef Warnings As Warning() _
) As String
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out)] 
[SoapDocumentMethodAttribute("", RequestNamespace="", ResponseNamespace="", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
public string CreateReportHistorySnapshot (
    string Report,
    out Warning[] Warnings
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction=SoapHeaderDirection::Out)] 
[SoapDocumentMethodAttribute(L"", RequestNamespace=L"", ResponseNamespace=L"", Use=SoapBindingUse::Literal, ParameterStyle=SoapParameterStyle::Wrapped)] 
String^ CreateReportHistorySnapshot (
    String^ Report, 
    [OutAttribute] array<Warning^>^% Warnings
/** @attribute SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) */ 
/** @attribute SoapDocumentMethodAttribute("", RequestNamespace="", ResponseNamespace="", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) */ 
/** @attribute SoapHeaderAttribute("BatchHeaderValue") */ 
public String CreateReportHistorySnapshot (
    String Report, 
    /** @attribute OutAttribute() */ /** @ref */ Warning[] Warnings
JScript does not support passing value-type arguments by reference.


  • Report
    The full path name of the report.
  • Warnings
    [out] An array of Warning objects that lists warnings that occurred during report processing.

Return Value

A string that represents the date and time stamp of the snapshot. This string is used as a unique identifier for the historical snapshot.


For the snapshot to be generated successfully, report history must be enabled for the report. To enable report history for a report, use the SetReportHistoryOptions method. For more information about report history, see Managing Report History.

If the report contains subreports, query result sets from the subreports are persisted in the report history snapshot. Report parameters that are passed to the report at the time the report is executed are also persisted.

Snapshots are created by the CreateReportHistorySnapshot method with default report parameters only. If you need to create report history snapshots with different parameter profiles, then use linked reports with CreateReportHistorySnapshot.

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.


Development Platforms

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

Target Platforms

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

See Also


ReportingService2005 Class
ReportingService2005 Members
Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005 Namespace