3.1.4.7.4 AddConfigSection (Opnum 6)

  • Article

The AddConfigSection method is received by the server in an RPC_REQUEST packet. In response, the server attempts to create a new empty IAppHostElement and add it to the specified IAppHostConfigLocation. The server MAY choose to create the IAppHostElement object in memory only and not persist it to permanent storage, such as a disk file, until later.

 HRESULT AddConfigSection(
   [in] BSTR bstrSectionName,
   [out, retval] IAppHostElement** ppAdminElement
 );

bstrSectionName: The name of the new IAppHostElement section to add.

ppAdminElement: Contains a newly created IAppHostElement.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. In this case, *ppAdminElement is not NULL. 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.

0X800700B7

ERROR_ALREADY_EXISTS

A configuration element with the name specified by bstrSectionName already exists.

0X80070013

ERROR_INVALID_DATA

Configuration data or schema on the server are malformed or corrupted.

0X80070021

ERROR_LOCK_VIOLATION

The instance is not editable.