Share via

3.1.4.13.4 DeleteElement (Opnum 6)

  • Article

The DeleteElement method is received by the server in an RPC_REQUEST packet. In response, the server deletes the IAppHostElement at the specified index.

 HRESULT DeleteElement(
   [in] VARIANT cIndex
 );

cIndex: A VARIANT that specifies the IAppHostElement object to return from the collection. If the VARIANT is of type integer, the index is a zero-based index to the collection, where 0 indicates the first IAppHostElement, 1 the second, and so on. If the VARIANT is of type IAppHostElement, the index is a "selector" IAppHostElement to the specified collection.

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.

0X80070057

ERROR_INVALID_PARAMETER

One or more parameters are incorrect or null.

0X00000008

ERROR_NOT_ENOUGH_MEMORY

Not enough memory is available to process this command.

0X80070021

ERROR_LOCK_VIOLATION

The instance is not editable.

0X80070585

ERROR_INVALID_INDEX

The index specified by cIndex is invalid.