Interface IBITSExtensionSetupFactory (bitscfg.h)
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 |