IFolderCreateFolderAsync Method

Task<IFolderMetadata> CreateFolderAsync(
	IFolderMetadata folderMetadata,
	IOperationContext operationContext,
	IInSyncResultContext inSyncResultContext,
	CancellationToken cancellationToken = null
)

Function CreateFolderAsync ( 
	folderMetadata As IFolderMetadata,
	operationContext As IOperationContext,
	inSyncResultContext As IInSyncResultContext,
	Optional cancellationToken As CancellationToken = Nothing
) As Task(Of IFolderMetadata)

Task<IFolderMetadata^>^ CreateFolderAsync(
	IFolderMetadata^ folderMetadata, 
	IOperationContext^ operationContext, 
	IInSyncResultContext^ inSyncResultContext, 
	CancellationToken cancellationToken = nullptr
)

abstract CreateFolderAsync : 
        folderMetadata : IFolderMetadata * 
        operationContext : IOperationContext * 
        inSyncResultContext : IInSyncResultContext * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _cancellationToken = defaultArg cancellationToken null
*)
-> Task<IFolderMetadata> 

Parameters

folderMetadata

Type: ITHit.FileSystemIFolderMetadata
Information about the new folder.

operationContext

Type: ITHit.FileSystemIOperationContext

inSyncResultContext

Type: ITHit.FileSystemIInSyncResultContext
If the SetInSync property is set to true the item is converted to a placeholder and is marked as in-sync. Otherwise the item remains a regular folder. The SetInSync property is true by default.

cancellationToken (Optional)

Type: System.ThreadingCancellationToken
The token to monitor for cancellation requests.

Return Value

• Remote storage item ID. It will be passed to GetFileSystemItem() during next calls. See RemoteStorageItemId description for more details about the remote storage item ID.
• Medatdata eTag. The Engine will store it to determine if the item metadata should be updated.

If this method completes without exceptions and the SetInSync property of the inSyncResultContext parameter is set to true the item is converted to a placeholder and is marked as in-sync. Otherwise, the folder is not converted to a placeholder and remains a regular folder.

Setting the SetInSync property of the inSyncResultContext parameter to false has the same affect as throwing an exception inside this method.

Reference