3.1.4.12.10 Clear (Opnum 12)

  • Article

The Clear method is received by the server in an RPC_REQUEST packet. In response, the server clears the contents of the specified IAppHostElement object. The administration system can choose to either perform the clearing of memory or persist it directly to permanent storage.

 HRESULT Clear();

This method has no parameters.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. If processing fails, the server MUST return a nonzero HRESULT code as defined in [MS-ERREF]. The following table describes the error conditions that MUST be handled and the corresponding error codes. A server MAY return additional implementation-specific error codes.

Return value/code

Description

0X00000000

NO_ERROR

The operation completed successfully.

0X80070021

ERROR_LOCK_VIOLATION

The element is not editable.