Поделиться через

Интерфейс IBITSExtensionSetup (bitscfg.h)

  • Статья

Используйте интерфейс IBITSExtensionSetup для включения или отключения отправки BITS в виртуальный каталог.

Этот интерфейс является расширением ADSI. Чтобы получить указатель на этот интерфейс, вызовите функцию ADSI ADsGetObject , как показано в примере кода.

При использовании этого интерфейса из программы установки, которая также устанавливает сервер BITS, необходимо вызвать метод IBITSExtensionSetupFactory::GetObject , чтобы получить указатель на этот интерфейс, а не вызывать функцию ADsGetObject .

Наследование

Интерфейс IBITSExtensionSetup наследуется от интерфейса IUnknown . IBITSExtensionSetup также имеет следующие типы членов:

Методы

Интерфейс IBITSExtensionSetup содержит следующие методы.

 
IBITSExtensionSetup::D isableBITSUploads

Используйте метод DisableBITSUploads, чтобы отключить отправку BITS в виртуальный каталог, на который указывает объект ADSI. Этот метод задает свойство расширения IIS BITSUploadEnabled.
IBITSExtensionSetup::EnableBITSUploads

Используйте метод EnableBITSUploads, чтобы включить отправку BITS в виртуальный каталог, на который указывает объект ADSI. Этот метод задает свойство расширения IIS BITSUploadEnabled.
IBITSExtensionSetup::GetCleanupTask

Используйте метод GetCleanupTask, чтобы получить указатель интерфейса на задачу очистки, связанную с виртуальным каталогом.
IBITSExtensionSetup::GetCleanupTaskName

Используйте метод GetCleanupTaskName, чтобы получить имя задачи очистки, связанной с виртуальным каталогом.

Комментарии

Этот интерфейс регистрируется на сервере при установке серверного расширения BITS.

В Windows Server 2003 установите расширение сервера BITS с помощью мастера компонентов Windows . В панель управления выберите Добавить или удалить программы. Затем выберите Add/Remove Windows Components (Добавить или удалить компоненты Windows ), чтобы открыть мастер компонентов Windows. Серверное расширение BITS является подкомпонентом служб IIS, которые являются подкомпонентом сервера веб-приложений.

Примеры

В следующем примере показано, как использовать функцию 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
Header bitscfg.h
Распространяемые компоненты BITS 1.5 в Windows XP

См. также раздел

IBITSExtensionSetupFactory