Antarmuka IBITSExtensionSetupFactory (bitscfg.h)

Artikel
02/28/2024

Gunakan antarmuka IBITSExtensionSetupFactory untuk mendapatkan pointer ke antarmuka IBITSExtensionSetup . Hanya gunakan antarmuka ini jika Anda menggunakan antarmuka IBITSExtensionSetup dalam program penyiapan yang juga menginstal server BITS. Karena cache IIS tidak berisi ekstensi BITS yang ditambahkan selama penyiapan, ekstensi tidak tersedia menggunakan fungsi ADsGetObject ADSI. Antarmuka IBITSExtensionSetupFactory menyediakan metode GetObject , yang mengakses ekstensi BITS dan melakukan pengikatan yang sama dengan fungsi ADsGetObject .

Untuk mendapatkan penunjuk ke antarmuka IBITSExtensionSetupFactory , panggil fungsi CoCreateInstance seperti yang ditunjukkan dalam Kode Contoh.

Warisan

Antarmuka IBITSExtensionSetupFactory mewarisi dari antarmuka IUnknown . IBITSExtensionSetupFactory juga memiliki jenis anggota ini:

Metode

Antarmuka IBITSExtensionSetupFactory memiliki metode ini.


IBITSExtensionSetupFactory::GetObject Gunakan metode GetObject untuk mengambil pointer ke antarmuka IBITSExtensionSetup. Metode ini melakukan pengikatan yang sama dengan yang dilakukan fungsi ADsGetObject ADSI.

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 antarmuka IBITSExtensionSetupFactory 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;
  IBITSExtensionSetupFactory* pExtensionSetupFactory = NULL;
  IBITSExtensionSetup* pExtensionSetup = NULL;

  hr = CoCreateInstance(__uuidof(BITSExtensionSetupFactory),
    NULL, CLSCTX_INPROC_SERVER,
    __UUIDOF(IBITSExtensionSetupFactory),
    (void**)&pExtensionSetupFactory);

  if (SUCCEEDED(hr))
  {
    hr = pExtensionSetupFactory->GetObject(BSTR(pszPath), &pExtensionSetup);
    if (SUCCEEDED(hr))
    {
      if (Enable)
      {
        hr = pExtensionSetup->EnableBITSUploads();
      }
      else
      {
        hr = pExtensionSetup->DisableBITSUploads();
      }

      pExtensionSetup->Release();
    }
    pExtensionSetupFactory->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

IBITSExtensionSetup

Bagikan melalui