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 サーバー拡張機能は、Web アプリケーション サーバーのサブコンポーネントであるインターネット インフォメーション サービス (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 |
| ヘッダー | bitscfg.h |
| 再頒布可能パッケージ | Windows XP の BITS 1.5 |