Compartilhar via

Interface IBITSExtensionSetupFactory (bitscfg.h)

  • Artigo

Use a interface IBITSExtensionSetupFactory para obter um ponteiro para a interface IBITSExtensionSetup . Use essa interface somente se você usar a interface IBITSExtensionSetup em um programa de instalação que também instale o servidor BITS. Como o cache do IIS não contém as extensões BITS adicionadas durante a instalação, as extensões não estão disponíveis usando a função ADSI ADsGetObject . A interface IBITSExtensionSetupFactory fornece um método GetObject , que acessa as extensões BITS e executa a mesma associação que a função ADsGetObject .

Para obter um ponteiro para a interface IBITSExtensionSetupFactory , chame a função CoCreateInstance , conforme mostrado em Código de Exemplo.

Herança

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

Métodos

A interface IBITSExtensionSetupFactory tem esses métodos.

 
IBITSExtensionSetupFactory::GetObject

Use o método GetObject para recuperar um ponteiro para a interface IBITSExtensionSetup. Esse método executa a mesma associação que a função ADSI ADsGetObject executa.

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 interface IBITSExtensionSetupFactory 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;
  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;
}

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

IBITSExtensionSetup