Interface IBITSExtensionSetupFactory (bitscfg.h)

Utilisez l’interface IBITSExtensionSetupFactory pour obtenir un pointeur vers l’interface IBITSExtensionSetup . Utilisez cette interface uniquement si vous utilisez l’interface IBITSExtensionSetup dans un programme d’installation qui installe également le serveur BITS. Étant donné que le cache IIS ne contient pas les extensions BITS ajoutées pendant l’installation, les extensions ne sont pas disponibles à l’aide de la fonction ADSI ADsGetObject . L’interface IBITSExtensionSetupFactory fournit une méthode GetObject , qui accède aux extensions BITS et effectue la même liaison que la fonction ADsGetObject .

Pour obtenir un pointeur vers l’interface IBITSExtensionSetupFactory , appelez la fonction CoCreateInstance , comme indiqué dans l’exemple de code.

Héritage

L’interface IBITSExtensionSetupFactory hérite de l’interface IUnknown. IBITSExtensionSetupFactory a également les types de membres suivants :

Méthodes

L’interface IBITSExtensionSetupFactory a ces méthodes.

IBITSExtensionSetupFactory ::GetObject Utilisez la méthode GetObject pour récupérer un pointeur vers l’interface IBITSExtensionSetup. Cette méthode effectue la même liaison que la fonction ADSI ADsGetObject.

Remarques

Cette interface est inscrite sur le serveur lorsque vous installez l’extension de serveur BITS.

Sur Windows Server 2003, utilisez l’Assistant Composants Windows pour installer l’extension de serveur BITS. Dans Panneau de configuration, sélectionnez Ajouter ou supprimer des programmes. Ensuite, sélectionnez Ajouter/supprimer des composants Windows pour afficher l’Assistant Composants Windows. L’extension de serveur BITS est un sous-composant d’Internet Information Services (IIS) qui est un sous-composant du serveur d’applications web.

Exemples

L’exemple suivant montre comment utiliser l’interface IBITSExtensionSetupFactory pour obtenir un pointeur vers l’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;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Windows
En-tête	bitscfg.h
Composant redistribuable	BITS 1.5 sur Windows XP

Voir aussi

IBITSExtensionSetup