ReportingService2010.SetRoleProperties Method

Sets role properties and associates a collection of tasks with a specified role. This method only applies to native mode.

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

Syntax

'Declaration
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetRoleProperties", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Sub SetRoleProperties ( _
    Name As String, _
    Description As String, _
    TaskIDs As String() _
)
'Usage
Dim instance As ReportingService2010 
Dim Name As String 
Dim Description As String 
Dim TaskIDs As String()

instance.SetRoleProperties(Name, Description, _
    TaskIDs)

[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetRoleProperties", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void SetRoleProperties(
    string Name,
    string Description,
    string[] TaskIDs
)

[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetRoleProperties", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
void SetRoleProperties(
    String^ Name, 
    String^ Description, 
    array<String^>^ TaskIDs
)

[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetRoleProperties", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member SetRoleProperties : 
        Name:string * 
        Description:string * 
        TaskIDs:string[] -> unit

public function SetRoleProperties(
    Name : String, 
    Description : String, 
    TaskIDs : String[]
)

Parameters

• Name
  Type: System.String
  The name of the role for which to set properties.

• Description
  Type: System.String
  Optional. A description of the role.

• TaskIDs
  Type: array<System.String[]
  An array of string objects that represent the tasks to set for the role.

Remarks

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

SOAP Header Usage	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Native Mode Required Permissions	UpdateRoleProperties (System)
SharePoint Mode Required Permissions	Not supported

This method throws an OperationNotSupportedSharePointMode exception when invoked in SharePoint mode.

When you use this method to change role properties, groups, users, and policies that are assigned to the role are affected.

See Also

Reference

ReportingService2010 Class

ReportService2010 Namespace