PutEx

The ADSI PutEx method sets the value for a single- or multi-valued metabase property in the object. You can use PutEx to remove (also called clear) a property from a metabase key.

Syntax

object.PutEx controlcode, property, value 
 

Parts

object

Contains the IIS Admin Object, usually as a result of a previous GetObject operation.

controlcode

Specifies whether to update the property or to remove the property from the object. One of: ADS_PROPERTY_CLEAR (value 1) to remove the property, or ADS_PROPERTY_UPDATE (value 2) to update the property.

property

A property of the object that has been retrieved from the metabase.

value

The value for the property. An empty string when removing the property (controlcode = ADS_PROPERTY_CLEAR).

Remarks

For a metabase property to use inherited data at a key, the property must not exist at the key. You can remove it by using ADS_PROPERTY_CLEAR. You can use the GetDataPaths method common to all IIS Admin Objects to locate the keys where a property exists.

Code Example

<% 
Dim IIsObj, vList 
Set IIsObj = GetObject("IIS://LocalHost/W3SVC/Info") 
' Get the value from the object 
vList = IIsObj.GetEx("CustomErrorDescriptions") 
' Modify the list 
 
' Put the values back in the object 
IIsObj.PutEx 2, "CustomErrorDescriptions", vList 
' Remove another property from the object
IIsObj.PutEx 1, "ObsoleteProperty", ""
IIsObj.SetInfo 
%> 

See Also

GetInfo, SetInfo, Get, Put, GetEx, GetInfoEx

© 1997 by Microsoft Corporation. All rights reserved.