3.2.4.5.2 SetConfig (Opnum 8)

  • Article

The SetConfig method sets WSRM configuration information concerning accounting and notifications.

 [id(2), helpstring("method SetConfig")] HRESULT SetConfig(
   [in] BSTR bstrConfigInfo,
   [in] CONFIGTYPE enumConfigType
 );

bstrConfigInfo: A string that contains WSRM configuration information. The type of information is determined by the value of the enumConfigType parameter.

If this parameter is NULL, E_INVALIDARG MUST be returned.

enumConfigType: A CONFIGTYPE enumeration (section 2.2.3.1) value that specifies the type of WSRM configuration information to set.

Setting calendar information is not supported. If this parameter is set to CONFIGTYPE_CALENDARING,  ERROR_NOT_SUPPORTED SHOULD be returned.

Value

Meaning

CONFIGTYPE_ACCOUNTING

1

The WSRM configuration information is in the form of an AccountingConfigInfo element (section 2.2.5.2).

CONFIGTYPE_NOTIFICATION

2

The WSRM configuration information is in the form of an NotificationConfigInfo element (section 2.2.5.19).

Return Values: This method returns 0x00000000 for success or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.

Return value/code

Description

0x00000000

S_OK

Operation successful.

0x80070005

ERROR_ACCESS_DENIED

Access is denied.

0x80070032

ERROR_NOT_SUPPORTED

The requested action is not supported.

0x80070057

E_INVALIDARG

One or more arguments are invalid.

0xC1FF006E

WRM_ERR_TOO_LONG_CONFIG_VALUE

One or more specified values have exceeded an implementation-defined limit.<72>

0xC1FF0070

WRM_ERR_TAGS_NOT_IN_ORDER

The XML data that is maintained by the management service is invalid or cannot be processed.<73>

0xC1FF0190

WRM_ERR_INVALID_NTFY_ENABLE

The notification-enabled value MUST be Boolean (section 2.2.1.2).

0xC1FF0194

WRM_ERR_INVALID_EVENTLIST

The notification event list format is invalid.

0xC1FF01F6

WRM_ERR_INVALID_ACC_ENABLE

The accounting-enabled value MUST be Boolean (section 2.2.1.2).

0xC1FF01F9

WRM_ERR_ACC_INVALID_DUMPING_INTERVAL

The logging interval for accounting is invalid. The interval MUST be between 2 and 60,000 minutes, inclusive.

Note When the CONFIGTYPE_ACCOUNTING option is used, an accounting client SHOULD call SetClientPermissions (section 3.2.4.3.14) prior to SetConfig in order to obtain authorization to modify an accounting database on a remote WSRM server. If a client does not have permission, ERROR_ACCESS_DENIED SHOULD be returned.<74>

Additional IWRMConfig interface methods are specified in section 3.2.4.5.