2025-04-27 07:49:33 -04:00

107 lines
4.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">
<TITLE>PutEx</TITLE>
<SCRIPT LANGUAGE="JavaScript">
<!--
TempString = navigator.appVersion
if (navigator.appName == "Microsoft Internet Explorer"){
// Check to see if browser is Microsoft
if (TempString.indexOf ("4.") >= 0){
// Check to see if it is IE 4
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/coua.css">');
}
else {
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/cocss.css">');
}
}
else if (navigator.appName == "Netscape") {
// Check to see if browser is Netscape
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/coua.css">');
}
else
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/cocss.css">');
//-->
</script>
<SCRIPT LANGUAGE="VBScript">
<!--
Sub Window_OnLoad()
Dim frmContents
On Error Resume Next
If Not Parent Is Nothing Then
Set frmContents = Parent.Contents
If Not frmContents Is Nothing Then
frmContents.Window.TOCSynch_Click
End If
End If
End Sub
//--></SCRIPT><META NAME="DESCRIPTION" CONTENT="Internet Information Services reference information">
<META HTTP-EQUIV="PICS-Label" CONTENT='(PICS-1.1 "<http://www.rsac.org/ratingsv01.html>" l comment "RSACi North America Server" by "inet@microsoft.com <mailto:inet@microsoft.com>" r (n 0 s 0 v 0 l 0))'>
<META NAME="MS.LOCALE" CONTENT="EN-US">
<META NAME="MS-IT-LOC" Content="Internet Information Services">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
<H4><A NAME="_k2_putex"></A><SUP></SUP>PutEx</H4>
<P>The ADSI <B>PutEx</B> method sets the value for a single-valued or multivalued metabase property in the object. You can use <B>PutEx</B> to remove, or clear, a property from a metabase key.</P>
<H6>Syntax</H6>
<P><I>object</I>.<B>PutEx</B> <I>controlcode</I>, <I>property</I>, <I>value</I> </P>
<P>&nbsp;</P>
<H6>Parts</H6>
<DL>
<DT><I>object</I></DT>
<DD>Contains an IIS Admin Object, usually as a result of a previous <B>GetObject</B> operation.<BR>
</DD>
<DT><I>controlcode</I></DT>
<DD>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.<BR>
</DD>
<DT><I>property</I></DT>
<DD>A property of the object that has been retrieved from the metabase.<BR>
</DD>
<DT><I>value</I></DT>
<DD>The value for the property. An empty string when removing the property (<I>controlcode</I> = ADS_PROPERTY_CLEAR).</DD>
</DL>
<H6>Remarks</H6>
<P>For a metabase property to use inherited data at a key, the property must not already exist at the key; if it does, you can remove it by using ADS_PROPERTY_CLEAR. (You can use the <A HREF="/iishelp/iis/htm/asp/adsi52wj.htm"><B>GetDataPaths</B></A> method common to all IIS Admin Objects to locate the keys where a property exists.)</P>
<H6>Code Example</H6>
<PRE><CODE>&lt;%
Dim IIsObj, vList
Set IIsObj = GetObject("IIS://<I>LocalHost</I>/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
%&gt; </CODE></PRE>
<H6>See Also</H6>
<P><A HREF="/iishelp/iis/htm/asp/adsi7vcf.htm"><B>GetInfo</B></A>, <A HREF="/iishelp/iis/htm/asp/adsi0elr.htm"><B>SetInfo</B></A>, <A HREF="/iishelp/iis/htm/asp/adsi5ius.htm"><B>Get</B></A>, <A HREF="/iishelp/iis/htm/asp/adsi6c38.htm"><B>Put</B></A>, <A HREF="/iishelp/iis/htm/asp/adsi5ewo.htm"><B>GetEx</B></A></P>
<hr class="iis" size="1">
<p align="center"><em><a href="../../../common/colegal.htm">&copy; 1997-2001 Microsoft Corporation. All rights reserved.</a></em></p>
</BODY>
</HTML>