Edit

Permission.Add method (Office)

  • Article

Creates a set of permissions on the active document for the specified user. Returns a UserPermission object.

Syntax

expression.Add (UserID, Permission, ExpirationDate)

expression Required. A variable that represents a Permission object.

Parameters

Name Required/Optional Data type Description
UserID Required String The email address (in the format user@domain.com) of the user to whom permissions on the active document are being granted.
Permission Optional MsoPermission The permissions on the active document that are being granted to the specified user.
ExpirationDate Optional Date The expiration date for the permissions that are being granted.

NOTE: this parameter is not used and will be ignored.

Example

The following example assigns a combination of read and edit permissions on the current document to a user and specifies an expiration date for these document permissions.

 Dim objUserPerm As Office.UserPermission 
 Set objUserPerm = ActiveWorkbook.Permission.Add( _ 
 "user@domain.com", _ 
 msoPermissionRead + msoPermissionEdit, #12/31/2005#) 
 MsgBox "Permissions added for " & _ 
 objUserPerm.UserId, _ 
 vbInformation + vbOKOnly, _ 
 "Permissions Added" 
 Set objUserPerm = Nothing

See also

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.