Security.CheckUserProjectPermission Method

Checks whether the current user has the specified security category permission for a specified project.

Namespace:  [Security Web service]
Service reference: http://ServerName:32843/[Project Service Application GUID]/PSI/Security.svc
Web service reference: http://ServerName/ProjectServerName/_vti_bin/PSI/Security.asmx?wsdl

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Security/CheckUserProjectPermission", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Security/",  _
    ResponseNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Security/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function CheckUserProjectPermission ( _
    projectUid As Guid, _
    categoryPermissionUid As Guid _
) As Boolean
'Usage
Dim instance As Security
Dim projectUid As Guid
Dim categoryPermissionUid As Guid
Dim returnValue As Boolean

returnValue = instance.CheckUserProjectPermission(projectUid, _
    categoryPermissionUid)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Security/CheckUserProjectPermission", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Security/", 
    ResponseNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Security/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public bool CheckUserProjectPermission(
    Guid projectUid,
    Guid categoryPermissionUid
)

Parameters

• projectUid
  Type: System.Guid
  The GUID of the project.

• categoryPermissionUid
  Type: System.Guid
  The GUID of the category permission.

Return Value

Type: System.Boolean
True if the current user has the category permission for the project; otherwise, false.

Remarks

CheckUserProjectPermission wraps a call to CheckUserObjectPermission. To check multiple category permissions for a project, use CheckUserProjectPermissions for better performance. Checking a category permission for another user on a project requires using impersonation to log on as that user.

For the categoryPermissionUid parameter, use the PSSecurityCategoryPermission structure to get the GUID for one of the default category permissions, or use ReadCategoryPermissions to get the GUID for a custom category permission.

Project Server Permissions

Examples

The following example checks whether the current user has the "Delete Project" permission for an existing project. For additional information and a complete sample application, see Using Security Methods in the PSI.

using System;
using System.Net;
using PSLibrary = Microsoft.Office.Project.Server.Library;
. . .
CookieContainer cookiecontainer = new CookieContainer();
SecurityWebSvc.Security security = new SecurityWebSvc.Security();
security.Url = "https://ServerName/ProjectServerName/_vti_bin/psi/security.asmx";
security.CookieContainer = cookiecontainer;
security.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the GUID for an existing project.
Guid projectUid = new Guid("a1fcbf91-e91d-44e2-a4a7-3b4b698cb984");
Guid categoryPermission = PSLibrary.PSSecurityCategoryPermission.DeleteProject;

bool hasDeleteProjectPermission = 
   security.CheckUserProjectPermission(projectUid,  categoryPermission);
. . .

See Also

Reference

Security Class

Security Members

Security Web Service

Other Resources

Using Security Methods in the PSI

Walkthrough: Creating and Using Custom Project Server Permissions