CreateFile Method
Initializes a new file.
Syntax
ANSI (Cross Platform) char* CreateFile(const char* lpszNewFilePath, int64 lFileLength); Unicode (Windows) LPWSTR CreateFile(LPCWSTR lpszNewFilePath, LONG64 lFileLength);
- (NSString*)createFile:(NSString*)newFilePath :(long long)fileLength;
#define MID_AZUREFILE_CREATEFILE 8 IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_AzureFile_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method initializes a new file with a given FileLength (in bytes) at the specified NewFilePath in the share currently selected by Share. The path of the newly-initialized file is returned.
Any parent folders included in NewFilePath must already exist.
If the SendMetadata configuration setting is enabled when this method is called, all items in the Metadata* properties will be sent along with the creation request.
Note: This method is typically only useful for advanced use-cases. To upload a file, just call UploadFile.
Usage Notes
This method does not upload or otherwise allocate any data, it just creates the file entry and "reserves" storage space for it. After a file has been created with this method, the following methods can be used to manipulate its data:
- The PutRange method can be used to upload ranges of data (up to 4MB at once) to the file.
- The ClearRange method can be used to clear an arbitrary range of data from the file, allowing the server to release the associated storage resources.
- The GetRanges method can be used to obtain a list of all data ranges present in the file.
Error Handling (C++)
This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.