Permission.Add Method (Office)

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

Permission Object

Permission Object Members