Skip to main content

TdxCloudStorage.CreateSharedLink(TdxCloudStorageItem,Boolean,TdxCloudStorageItemPermissionScope) Method

Creates a shared link with a permission to view or edit a file or folder on a connected storage server.

Declaration

function CreateSharedLink(AItem: TdxCloudStorageItem; AReadOnly: Boolean = True; AScope: TdxCloudStorageItemPermissionScope = TdxCloudStorageItemPermissionScope.Anonymous): TdxCloudStorageItemPermission;

Parameters

Name Type Description
AItem TdxCloudStorageItem

A cloud storage metadata container that corresponds to the target file or folder.

AReadOnly Boolean

If True, the function creates a read-only access permission; otherwise, creates a permission to edit the cloud resource.

AScope TdxCloudStorageItemPermissionScope

Enumerates access permission scopes.

Returns

Type Description
TdxCloudStorageItemPermission

An access permission.

Remarks

Call this function to create a new permission to view a file or folder on a cloud storage server with anonymous access. The CreateSharedLink function returns a new access permission. You can use its Link property to obtain the associated shared link. To revoke any access permission and render the shared link invalid, call the DeletePermission procedure and pass the target permission as a parameter.

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

The optional Scope parameter specifies the scope of the newly created access permission. You can pass TdxCloudStoragePermissionScope.Organization as this parameter to create a shared link usable only by members of the organization to which the connected Microsoft SharePoint® or OneDrive® storage account belongs.

Note

A CreateSharedLink procedure call raises the OnItemPermissionCreated event when a shared link is successfully created.

Important

The AScope parameter value affects only Microsoft cloud storage accounts. This parameter is always ignored for any other cloud storage provider. Refer to the TdxCloudStorageItemPermissionScope type description for detailed information.

See Also