IBITSExtensionSetup 接口 (bitscfg.h)

使用 IBITSExtensionSetup 接口启用或禁用将 BITS 上传到虚拟目录。

此接口是 ADSI 扩展。 若要获取指向此接口的指针，请调用 ADsGetObject ADSI 函数，如示例代码中所示。

如果从同时安装 BITS 服务器的安装程序使用此接口，则必须调用 IBITSExtensionSetupFactory：：GetObject 方法来获取指向此接口的指针，而不是调用 ADsGetObject 函数。

继承

IBITSExtensionSetup 接口继承自 IUnknown 接口。 IBITSExtensionSetup 还具有以下类型的成员：

方法

IBITSExtensionSetup 接口具有以下方法。

IBITSExtensionSetup：:D isableBITSUploads 使用 DisableBITSUploads 方法在 ADSI 对象指向的虚拟目录上禁用 BITS 上传。 此方法设置 BITSUploadEnabled IIS 扩展属性。
IBITSExtensionSetup：：EnableBITSUploads 使用 EnableBITSUploads 方法在 ADSI 对象指向的虚拟目录上启用 BITS 上传。 此方法设置 BITSUploadEnabled IIS 扩展属性。
IBITSExtensionSetup：：GetCleanupTask 使用 GetCleanupTask 方法检索指向与虚拟目录关联的清理任务的接口指针。
IBITSExtensionSetup：：GetCleanupTaskName 使用 GetCleanupTaskName 方法检索与虚拟目录关联的清理任务的名称。

注解

安装 BITS 服务器扩展时，会在服务器上注册此接口。

在 Windows Server 2003 上，使用 Windows 组件向导 安装 BITS 服务器扩展。 从控制面板，选择“添加或删除程序”。 然后，选择 “添加/删除 Windows 组件” 以显示 Windows 组件向导。 BITS 服务器扩展是 Internet Information Services (IIS) 的子组件，它是 Web 应用程序服务器的子组件。

示例

以下示例演示如何使用 ADsGetObject 函数获取指向 IBITSExtensionSetup 接口的指针。

//Set the BITSUploadEnabled IIS configuration setting.
//The pszPath parameter contains the path to the directory service. 
//For example, "IIS://<machine name>/w3svc/1/<virtual directory>".
//The Enable parameter contains true (enable) or false (disable).
HRESULT SetBITSUploadEnabledSetting(LPWSTR pszPath, bool Enable)
{
  HRESULT hr;
  IBITSExtensionSetup* pExtensionSetup = NULL;

  hr = ADsGetObject(pszPath, __uuidof(IBITSExtensionSetup), &pExtensionSetup);
  if (SUCCEEDED(hr))
  {
    if (Enable)
    {
      hr = pExtensionSetup->EnableBITSUploads();
    }
    else
    {
      hr = pExtensionSetup->DisableBITSUploads();
    }

    pExtensionSetup->Release();
  }

  return hr;
}

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2003
目标平台	Windows
标头	bitscfg.h
可再发行组件	Windows XP 上的 BITS 1.5

另请参阅

IBITSExtensionSetupFactory