<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">
<TITLE>SetName</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">
<H3><A NAME="_k2_setname"></A><SUP></SUP>SetName</H3>
<P>The <B>SetName</B> method of the <A HREF="/iishelp/iis/htm/asp/aore4qia.htm"><B>IIsCertMapper</B></A> object sets a new value for the name string in an existing certificate mapping. Four seek methods are available to search for the mapping: by certificate, by name, by Windows account, and by numeric string index.</P>
<H6>Syntax</H6>
<P><B>IIsCertMapper</B>.<B>SetName</B> <I>IMethod</I>, <I>vKey</I>, <I>strName</I> </P>
<P> </P>
<H6>Parameters</H6>
<DL>
<DT><I>IMethod</I></DT>
<DD>Specifies the seek method to use for searching the mappings. Valid seek methods are 1, 2, 3, or 4. Seek method 1 specifies search by certificate, seek method 2 searches by name, method 3 searches by Windows account, and method 4 searches by a 1-based numeric string index (for example, "1", "2", and so on).<BR>
</DD>
<DT><I>vKey</I></DT>
<DD>Specifies the key to use in the search specified by <I>IMethod</I>. For seek method 1, <I>vKey</I> specifies a certificate. For seek method 2, <I>vKey</I> specifies a name. For seek method 3, <I>vKey</I> specifies a Windows account. For seek method 4, <I>vKey</I> specifies a numeric string index (for example, "1," "2," and so on).<BR>
</DD>
<DT><I>strName</I></DT>
<DD>Specifies a new value for the name string.</DD>
</DL>
<H6>Code Example</H6>
<PRE><CODE><%
Dim CertObj
Set CertObj = GetObject("IIS://..<I>path</I>../IIsCertMapper")
'Search by Windows account.
CertObj.SetName 3, "MYACCT", "NewName"
%>
</CODE></PRE>
<H6>See Also</H6>
<P><A HREF="/iishelp/iis/htm/asp/aore3mqv.htm"><B>CreateMapping</B></A>, <A HREF="/iishelp/iis/htm/asp/aore2s13.htm"><B>DeleteMapping</B></A>, <A HREF="/iishelp/iis/htm/asp/aore0wvb.htm"><B>GetMapping</B></A>, <A HREF="/iishelp/iis/htm/asp/aore4his.htm"><B>SetAcct</B></A>, <A HREF="/iishelp/iis/htm/asp/aore5e78.htm"><B>SetEnabled</B></A>, <A HREF="/iishelp/iis/htm/asp/aore5msk.htm"><B>SetPwd</B></A></P>
<hr class="iis" size="1">
<p align="center"><em><a href="../../../common/colegal.htm">© 1997-2001 Microsoft Corporation. All rights reserved.</a></em></p>
</BODY>
</HTML>