IAuthorizationExtension.CheckAccess Method (String, IntPtr, Byte[], CatalogOperation[])

Article
12/03/2008

Indicates whether a user is authorized to access an item in the report server database for a given array of catalog operation. This method is not CLS-compliant.

Namespace: Microsoft.ReportingServices.Interfaces
Assembly: Microsoft.ReportingServices.Interfaces (in microsoft.reportingservices.interfaces.dll)

Syntax

'Declaration
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey:="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
Function CheckAccess ( _
    userName As String, _
    userToken As IntPtr, _
    secDesc As Byte(), _
    requiredOperations As CatalogOperation() _
) As Boolean

[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
bool CheckAccess (
    string userName,
    IntPtr userToken,
    byte[] secDesc,
    CatalogOperation[] requiredOperations
)

[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey=L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
bool CheckAccess (
    String^ userName, 
    IntPtr userToken, 
    array<unsigned char>^ secDesc, 
    array<CatalogOperation>^ requiredOperations
)

/** @attribute StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8") */ 
boolean CheckAccess (
    String userName, 
    IntPtr userToken, 
    byte[] secDesc, 
    CatalogOperation[] requiredOperations
)

function CheckAccess (
    userName : String, 
    userToken : IntPtr, 
    secDesc : byte[], 
    requiredOperations : CatalogOperation[]
) : boolean

Parameters

userName
The name of the user requesting access to the report server.

userToken
A user account token. This token is primarily used by the report server as a handle to a Microsoft Windows account in support of credential management for Windows authentication.

secDesc
The security descriptor for the item.

requiredOperations
The operations being requested by the report server for a given user.

Return Value

Returns true if the currently authenticated user is granted access to the item based on the supplied operation and security descriptor.

Example

The following example code uses the CheckAccess method to evaluate a user's authorization credentials against a security descriptor for an item in the report server database. The example makes use of the overloaded CheckAccess method that takes a single operation as an argument.

' Overload for array of catalog operations
Public Function CheckAccess(userName As String, userToken As IntPtr, secDesc() As Byte, requiredOperations() As CatalogOperation) As Boolean
   Dim operation As CatalogOperation
   For Each operation In  requiredOperations
      If Not CheckAccess(userName, userToken, secDesc, operation) Then
         Return False
      End If
   Next operation
   Return True
End Function 'CheckAccess
// Overload for array of catalog operations
public bool CheckAccess(string userName, IntPtr userToken, byte[] secDesc, CatalogOperation[] requiredOperations)
{
   foreach(CatalogOperation operation in requiredOperations)
   {
      if (!CheckAccess(userName, userToken, secDesc, operation))
         return false;
   }
   return true; 
}

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.

Platforms

Development Platforms

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

Target Platforms