ReportingService2010.DeleteItemHistorySnapshot(String, String) Method

Definition

Deletes an individual item history snapshot for a specified catalog item. If errors occur, the item history snapshot is not deleted. This method applies to the Report item type.

public:
 void DeleteItemHistorySnapshot(System::String ^ ItemPath, System::String ^ HistoryID);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/DeleteItemHistorySnapshot", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void DeleteItemHistorySnapshot (string ItemPath, string HistoryID);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/DeleteItemHistorySnapshot", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.DeleteItemHistorySnapshot : string * string -> unit
Public Sub DeleteItemHistorySnapshot (ItemPath As String, HistoryID As String)

Parameters

ItemPath
String

The fully qualified URL of the item including the file name and, in SharePoint mode, the extension.

HistoryID
String

The ID of the item history snapshot to be deleted, returned by the CreateItemHistorySnapshot(String, Warning[]) method.

Attributes

Remarks

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

SOAP Header Usage (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Native Mode Required Permissions DeleteHistory
SharePoint Mode Required Permissions <xref:Microsoft.SharePoint.SPBasePermissions.DeleteVersions>

The length of the ItemPath parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

The ItemPath parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.

Use the ListItemHistory method to retrieve the HistoryID property of the item history snapshot that you want to delete.

Applies to