DeleteEntry Method

Deletes an entry within an OData service resource.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int DeleteEntry();

Unicode (Windows)
INT DeleteEntry();

- (void)deleteEntry;

#define MID_ODATA_DELETEENTRY 5

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

Remarks

The component will delete the entry, of an OData service resource, specified by ServiceRootURI and ResourcePath (ServiceRootURI/ResourcePath).

An "If-Match" header will be sent in the delete request with the value contained within EntryETag.

Upon a successful entry deletion, all previous entries contained by the component, prior to the DeleteEntry call, will be cleared. 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.)