Skip to main content

TdxCloudStorageItemPermissions.InviteUsers(TArray<string>,Boolean,Boolean,Boolean,string) Method

Adds one or more permissions to view or edit a file or folder for all specified users.

Declaration

procedure InviteUsers(const AUsers: TArray<string>; AReadOnly: Boolean = True; ARequireSignIn: Boolean = False; ASendInvitation: Boolean = False; const AMessage: string = '');

Parameters

Name Type Description
AUsers TArray<T>

An array of emails for which the function generates access permissions.

AReadOnly Boolean

If True, the function generates read-only access permissions for the specified users; otherwise, the users can edit the cloud resource.

ARequireSignIn Boolean

If True, the specified users need to sign in to a Microsoft OneDrive® or SharePoint® storage account to access the cloud resource; otherwise, the generated access permissions allow anonymous access. This parameter value affects only Microsoft services.

ASendInvitation Boolean

If True, the cloud storage sends invitation emails to all specified users; otherwise, users receive no notifications.

AMessage string

A custom message sent in invitation emails. This parameter has no effect if the ASendInvitation parameter value is False.

Remarks

Call this procedure and pass an array of emails as the AUsers parameter to create a series of read-only access permissions for the specified users.

You can pass False as the optional AReadOnly parameter to create a series of permissions to edit the cloud resource instead.

The optional ARequireSignIn parameter specifies if the specified users need to sign into a Microsoft OneDrive® or SharePoint® storage account to access the shared resource. This parameter value is ignored for all other supported cloud storage services.

The optional ASendInvitation parameter specifies whether the cloud storage service should send invitation emails to all specified users. You can also use the optional AMessage parameter to add a custom message to sent invitations.

Note

A cloud storage component’s OnItemPermissionCreated event occurs every time the InviteUsers procedure creates a permission. This event can occur multiple times per single InviteUsers procedure call, and once per user specified in the AUsers array.

See Also