IPWorks Cloud 2020 C++ Edition

Questions / Feedback?

TruncateFile Method

Truncates a file to a given size.

Syntax

ANSI (Cross Platform)
int TruncateFile(const char* lpszFilePath, int64 lNewSize);

Unicode (Windows)
INT TruncateFile(LPCWSTR lpszFilePath, LONG64 lNewSize);
- (BOOL)truncateFile:(NSString*)filePath :(long long)newSize;
#define MID_HADOOPDFS_TRUNCATEFILE 22

IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_HadoopDFS_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method truncates the file at FilePath to the given NewSize (specified in bytes). NewSize must not be less than 0 or greater than the file's current size.

This method returns true if the file has been truncated successfully and is immediately ready for further modifications.

This method returns false if the server is still in the process of truncating the file (this could happen, e.g., if the server needs to truncate multiple replicas of the file). In this case, the server will reject any further attempts to modify the file until it has finished truncating it. Monitor the file's size using GetResourceInfo to determine when the truncation process has finished.

Error Handling (C++)

This method returns a Boolean 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.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Cloud 2020 C++ Edition - Version 20.0 [Build 8265]