GetFileInfo Method

Gets a file's information and metadata.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int GetFileInfo(const char* lpszFileId);

Unicode (Windows)
INT GetFileInfo(LPCWSTR lpszFileId);

- (void)getFileInfo:(NSString*)fileId;

#define MID_BACKBLAZEB2_GETFILEINFO 20

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

Remarks

This method gets information and metadata for the file version specified by FileId (which must be a real file version, or a hide marker, not a multipart upload).

Calling this method will fire the FileList and MetadataList events, and will re-populate the File* and Metadata* properties.

The currently-authenticated application key must have the readFiles capability to call this method successfully, otherwise the server will return an error. Refer to the AccountCapabilities property for more information.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)