Antarmuka IBITSExtensionSetup (bitscfg.h)

Gunakan antarmuka IBITSExtensionSetup untuk mengaktifkan atau menonaktifkan unggahan BITS ke direktori virtual.

Antarmuka ini adalah ekstensi ADSI. Untuk mendapatkan penunjuk ke antarmuka ini, panggil fungsi ADsGetObject ADSI seperti yang ditunjukkan dalam Kode Contoh.

Jika Anda menggunakan antarmuka ini dari program penyiapan yang juga menginstal server BITS, Anda harus memanggil metode IBITSExtensionSetupFactory::GetObject untuk mendapatkan pointer ke antarmuka ini alih-alih memanggil fungsi ADsGetObject .

Warisan

Antarmuka IBITSExtensionSetup mewarisi dari antarmuka IUnknown . IBITSExtensionSetup juga memiliki jenis anggota berikut:

Metode

Antarmuka IBITSExtensionSetup memiliki metode ini.

IBITSExtensionSetup::D isableBITSUploads Gunakan metode DisableBITSUploads untuk menonaktifkan unggahan BITS pada direktori virtual tempat objek ADSI menunjuk. Metode ini mengatur properti ekstensi IIS BITSUploadEnabled.
IBITSExtensionSetup::EnableBITSUploads Gunakan metode EnableBITSUploads untuk mengaktifkan unggahan BITS pada direktori virtual tempat objek ADSI menunjuk. Metode ini mengatur properti ekstensi IIS BITSUploadEnabled.
IBITSExtensionSetup::GetCleanupTask Gunakan metode GetCleanupTask untuk mengambil penunjuk antarmuka ke tugas pembersihan yang terkait dengan direktori virtual.
IBITSExtensionSetup::GetCleanupTaskName Gunakan metode GetCleanupTaskName untuk mengambil nama tugas pembersihan yang terkait dengan direktori virtual.

Keterangan

Antarmuka ini terdaftar di server ketika Anda menginstal ekstensi server BITS.

Pada Windows Server 2003, gunakan Wizard Komponen Windows untuk menginstal ekstensi server BITS. Dari Panel Kontrol, pilih Tambahkan atau Hapus Program. Kemudian, pilih Tambahkan/Hapus Komponen Windows untuk menampilkan Wizard Komponen Windows. Ekstensi server BITS adalah sub-komponen Internet Information Services (IIS) yang merupakan sub-komponen Server Aplikasi Web.

Contoh

Contoh berikut menunjukkan cara menggunakan fungsi ADsGetObject untuk mendapatkan pointer ke antarmuka 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;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2003
Target Platform	Windows
Header	bitscfg.h
Redistribusi	BITS 1.5 pada Windows XP

Lihat juga

IBITSExtensionSetupFactory