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