UpdateEntry Method

Update an OData entry.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int UpdateEntry();

Unicode (Windows)
INT UpdateEntry();

- (void)updateEntry;

#define MID_ODATA_UPDATEENTRY 15

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_OData_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

The class will update the OData entry specified by ServiceRootURI and ResourcePath (ServiceRootURI/ResourcePath). It will update the OData entry with the elements specified by EntryProperties.

Upon a successful update, all previous entries contained by the component, prior to the UpdateEntry call, will be cleared and replaced with the response entry data. EntryIndex will then be set to 0 (the first entry within the response), populating the EntryAuthor, EntryETag, EntryTitle, EntrySummary, EntryUpdated, EntryLinks, EntryProperties and ResourcePath properties. OtherHeaders will also be cleared and thus will need to be reset accordingly with each call made.

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.)