Interface IBITSExtensionSetup (bitscfg.h)

Use a interface IBITSExtensionSetup para habilitar ou desabilitar uploads de BITS em um diretório virtual.

Essa interface é uma extensão ADSI. Para obter um ponteiro para essa interface, chame a função ADSI ADsGetObject , conforme mostrado em Código de Exemplo.

Se você usar essa interface de um programa de instalação que também instala o servidor BITS, deverá chamar o método IBITSExtensionSetupFactory::GetObject para obter um ponteiro para essa interface em vez de chamar a função ADsGetObject .

Herança

A interface IBITSExtensionSetup herda da interface IUnknown . IBITSExtensionSetup também tem estes tipos de membros:

Métodos

A interface IBITSExtensionSetup tem esses métodos.

IBITSExtensionSetup::D isableBITSUploads Use o método DisableBITSUploads para desabilitar o upload de BITS no diretório virtual para o qual o objeto ADSI aponta. Esse método define a propriedade de extensão do IIS BITSUploadEnabled.
IBITSExtensionSetup::EnableBITSUploads Use o método EnableBITSUploads para habilitar o upload de BITS no diretório virtual para o qual o objeto ADSI aponta. Esse método define a propriedade de extensão do IIS BITSUploadEnabled.
IBITSExtensionSetup::GetCleanupTask Use o método GetCleanupTask para recuperar um ponteiro de interface para a tarefa de limpeza associada ao diretório virtual.
IBITSExtensionSetup::GetCleanupTaskName Use o método GetCleanupTaskName para recuperar o nome da tarefa de limpeza associada ao diretório virtual.

Comentários

Essa interface é registrada no servidor quando você instala a extensão de servidor BITS.

No Windows Server 2003, use o Assistente de Componentes do Windows para instalar a extensão de servidor BITS. Em Painel de Controle, selecione Adicionar ou Remover Programas. Em seguida, selecione Adicionar/Remover Componentes do Windows para exibir o Assistente de Componentes do Windows. A extensão de servidor BITS é um subcomponentes do IIS (Serviços de Informações da Internet) que é um subcomponentes do Servidor de Aplicativos Web.

Exemplos

O exemplo a seguir mostra como usar a função ADsGetObject para obter um ponteiro para a interface 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;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2003
Plataforma de Destino	Windows
Cabeçalho	bitscfg.h
Redistribuível	BITS 1.5 no Windows XP

Confira também

IBITSExtensionSetupFactory