Leaked source code of windows server 2003
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
<HTML><HEAD><TITLE>Co-installer for Processing DDInstall.WMI</TITLE><META content="text/html; charset=windows-1252" http-equiv=Content-Type><META content="Microsoft FrontPage 5.0" name=GENERATOR></HEAD>
<BODY link=#0000ff><FONT face=Verdana size=5><H2>Co-installer for Processing DDInstall.WMI</H2></FONT><FONT face=Verdana size=2><P><SPAN style="COLOR: #ff0000; FONT-FAMILY: Arial; FONT-SIZE: 10pt">[This is preliminary documentation and subject to change.]</SPAN></P><P><b><i style="mso-bidi-font-style:normal"><span style="font-size:9.5pt;mso-bidi-font-size:10.0pt;font-family:Arial">Abstract:</span></i></b>This document accompanies the redistributable co-installer that can be used inside an INF file to process the [<i><u>DDInstall</u></i>.WMI] on Windows 2000 and Windows XP. The functionality is already included in Windows Server 2003 and later.<H3>SUMMARY</H3><p>It is crucial to set WMI security correctly for any WMI Interface classes installed by the driver package. This has been done in the past by writing directly to the registry. A new syntax was added to Windows Server 2003 to provide a more convenient way of setting security on WMI Interfaces as follows:<p> <p><b> [</b><i>install-section-name</i><b>.WMI]</b> |<br><b> [</b><i>install-section-name</i><b>.nt.WMI]</b> | <br><b> [</b><i>install-section-name</i><b>.ntx86.WMI]</b> <br><b> [</b><i>install-section-name</i><b>.ntia64.WMI]</b> <br> <br><b> WMIInterface={</b><i>WmiClassGUID</i><b>},</b> [<i>flags</i>]<b>,</b><i>WMI-class-section<br></i><b> </b><br><b> </b></p><p><b> [</b><i>WMI-class-section</i><b>]</b> <br><b> Security="</b><i>security-descriptor-string</i><b>"</b></p><p>This document accompanies and describes a redistributableco-installer that can be used to process the <u>[</u><i>DDInstall</i>.WMI] install section in an INF. The [<i>DDInstall</i>.WMI] section is supported on Windows Server 2003 and later. The co-installer is only required to support this syntax on Windows 2000 and Windows XP.<H3>USING THE CO-INSTALLER</H3><h5>To use the co-installer for driver installation and registration:</h5><p style="margin-left:0in;tab-stops:.5in">Copy the WMIInst.dll redistributable binary to the directorywhere you are assembling your driver package. You should use this followingversion of wmiinst.dll:<blockquote><p><b>tools\coinstallers\</b><i><platform></i><b>\WMIInst.dll</b></blockquote><p>To use this co-installer, add the following sections to the INF:
<p><span style="font-family:Symbol">�<span style="font:7.0pt "Times New Roman""> </span></span>Add a [<i>DDInstall</i>.CoInstallers] section for each devicespecified in the INF. This section must include the following two lines:<blockquote><p><style="margin-left:.5in">AddReg = WMIInst.AddReg<br>CopyFiles= WMIInst.CopyFiles</blockquote>
<blockquote><p><style="margin-left:.5in">For example:</blockquote>
<blockquote><p><style="margin-left:.5in">[InstallA.NT.CoInstallers]<br>AddReg = WMIInst.AddReg<br>CopyFiles= WMIInst.CopyFiles</blockquote>
<p> <span style="font-family:Symbol">�<span style="font:7.0pt "Times New Roman""> </span></span>Add the following sections:
<blockquote><p><style="margin-left:.5in">[WMIInst.AddReg]<br>HKR,,CoInstallers32,0x10000,"WMIInst.DLL,WmiGuidSecurityINF"<br style="mso-special-character:line-break"><br style="mso-special-character:line-break"><style="margin-left:.5in">[WMIInst.CopyFiles]<br>WMIInst.dll,,,0x10</blockquote>
<p style="tab-stops:list .25in"><span style="font-family:Symbol">�<span style="font:7.0pt "Times New Roman""> </span></span>Add a reference to the CopyFiles section in the [DestinationDirs]section. For example:
<blockquote><p><style="margin-left:.5in">[DestinationDirs]<br>WMIInst.CopyFiles = 11</blockquote>
<p><span style="font-family:Symbol">�<span style="font:7.0pt "Times New Roman""> </span></span>Add sections to install the drivers and set WMI security.<br style="mso-special-character:line-break"><br style="mso-special-character:line-break">File Manifest</FONT><FONT face="Courier" size="3"><TABLE BORDER=0 CELLSPACING=1 CELLPADDING=0 width="744"><TR><TD width="200"><U>File</u></TD><TD width="534"><u>Description<u></TD></TR><TR><TD width="200"><i><FONT face=Verdana size=2> WMIInst</FONT>.htm</i></TD><TD width="534">Documentation for this binary (this file).</TD></TR><TR><TD width="200"><i><platform>\WMIInst.dll</i></TD><TD width="534">Redistributable 32-bit co-installer binary.</TD></TR></TABLE>
<H3>FEEDBACK</H3><P>We welcome your comments, problem reports and wish-list requests. Please submit them by pointing your Internet browser to <A href="http://www.microsoft.com/ddk">http://www.microsoft.com/ddk</A>. </FONT></P><P align=center><FONT face=Verdana size=2><A href="#top">Top of page</A></P></FONT><TABLE border=0" cellSpacing="0" width="624"><TR><TD bgColor="#00ffff" height="2" vAlign="middle"></TD></TR></TABLE><FONT face="MS Sans Serif" size=1><P>� Microsoft Corporation 2002</FONT><FONT face=Verdana size=2> </P></FONT></BODY>
|
