Security.CheckUserGlobalPermission Method

Checks whether the current user has a single specified global permission.

Namespace:  WebSvcSecurity
Assembly:  ProjectServerWebServices (in ProjectServerWebServices.dll)

Syntax

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

returnValue = instance.CheckUserGlobalPermission(globalPermissionUid)
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Security/CheckUserGlobalPermission", RequestNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Security/", 
    ResponseNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Security/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public bool CheckUserGlobalPermission(
    Guid globalPermissionUid
)

Parameters

  • globalPermissionUid
    Type: System.Guid
    GUID for a global permission.

Return Value

Type: System.Boolean
true if the current user has the permission.

Remarks

To check multiple global permissions, use CheckUserGlobalPermissions for better performance. To check a security permission for another resource requires using impersonation to log on as that resource.

For the globalPermissionUids parameter, use the PSSecurityCategoryPermission structure to get the GUID value of a default global permission, or use ReadGlobalPermissions to get the GUID for a custom global permission.

Project Server Permissions

Permission

Description

LogOn

Log on Project Server. Global permission.

Examples

The following example checks if the current user has the "About Project Server" permission. For additional information and a complete sample application that checks global permissions, 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 = "http://ServerName/ProjectServerName/_vti_bin/psi/security.asmx";
security.CookieContainer = cookiecontainer;
security.Credentials = System.Net.CredentialCache.DefaultCredentials;

//Check if the user has the "About Project Server" permission.
bool hasPermission = 
   security.CheckUserGlobalPermission(PSLibrary.PSSecurityGlobalPermission.AboutMicrosoftOfficeProjectServer);
. . .

See Also

Reference

Security Class

Security Members

WebSvcSecurity Namespace

Other Resources

Using Security Methods in the PSI

Walkthrough: Creating and Using Custom Project Server Permissions