3.1.4.28.4 DeleteSection (Opnum 6)

The DeleteSection method is received by the server in an RPC_REQUEST packet. In response, the server deletes the specified section definition.

 HRESULT DeleteSection(
   [in] VARIANT varIndex
 );

varIndex:  A VARIANT index that specifies the section definition to delete. If the VARIANT is of type integer, the index is a zero-based index to the collection. If the VARIANT is of type string, the index is the string name of the section definition.

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.

0X80070585

ERROR_INVALID_INDEX

The integer index specified by varIndex is invalid, or the section with name specified by cIndex could not be found.

0X80070021

ERROR_LOCK_VIOLATION

The instance is set to read-only.

0X00000002

ERROR_PATH_NOT_FOUND

The system cannot find the path specified.The section could not be found.