IIsFtpService.CreateNewSite (WMI)

CreateNewSite 方法在 IIS 6.0 服务器上创建一个新的 FTP 站点。CreateNewSite 的工作方式如下所示：

• 如果此方法成功，则它返回一个对新创建站点的站点标识号的引用。
• 如果此方法创建站点失败，则它返回一个错误。如果 ServerId 不存在，则可能会发生这种情况。如果具有要使用的 ServerComment 的站点已存在，则不返回错误，因为仍会创建具有唯一站点标识号的新站点。请参阅“注释”。

ServerComment [in]
包含代表新 FTP 站点 ServerComment 的字符串。在 IIS 管理器中，它对应于 FTP 站点属性页“FTP 站点标识”下面的“描述”字段。

ServerBindings[] [in]
包含 ServerBinding 类的实例数组，用来指定在该站点上要使用的服务器绑定方式。每个 ServerBinding 实例至少包含主机名称、端口和 IP 地址中的一项。

PathOfRootVirtualDir [in]
包含一个字符串，用来代表要将 FTP 站点映射到的物理目录的完全合格的路径。

ServerId [in,optional]
包含想要该方法使用的站点标识号的可选字符串参数。如果此参数为空，则使用哈希函数来创建站点标识号。请参阅上面的信息。

注释

在 IIS 配置数据库中，FTP 站点由服务类型和唯一站点标识号来代表。例如，在新安装的 IIS 上，“默认 FTP 站点”在 ADSI 中以 msftpsvc/1 来表示。

在 IIS 5.1 和更早版本中，每创建一个新站点，站点标识号就会增加 1。例如，如果创建了一个名为 Contoso 的 FTP 站点并以 msftpsvc/3 来代表它,那么下一个要创建的站点就是 msftpsvc/4。

CreateNewSite 允许您指定要使用的站点标识号。如果没有指定站点标识号，则该方法在传递给此方法的 ServerComment 上执行哈希函数，并创建一个新的号码。如果多个站点具有相同的 ServerComment，哈希函数就会检测到冲突，并选择下一个可用的站点标识号。例如，使用以下代码行创建一个站点：

myNewSiteID = IIsWebServiceObj.CreateNewSite("MyNewSite", Bindings, "C:\Inetpub\Wwwroot")

如果服务器上已经有一个名为 MyNewSite、标识号为 5555的 FTP 站点，当 5556 未被占用时，CreateNewSite 将返回 5556。

如果在多个 IIS 6.0 服务器上使用 IIS 管理器或 CreateNewSite 方法创建副本站点，则在每个服务器上的副本站点的站点标识号很可能会相同。