Interface IBITSExtensionSetup (bitscfg.h)

Article
02/23/2024

Utilisez l’interface IBITSExtensionSetup pour activer ou désactiver les chargements BITS dans un répertoire virtuel.

Cette interface est une extension ADSI. Pour obtenir un pointeur vers cette interface, appelez la fonction ADsGetObject ADSI comme indiqué dans l’exemple de code.

Si vous utilisez cette interface à partir d’un programme d’installation qui installe également le serveur BITS, vous devez appeler la méthode IBITSExtensionSetupFactory ::GetObject pour obtenir un pointeur vers cette interface au lieu d’appeler la fonction ADsGetObject .

Héritage

L’interface IBITSExtensionSetup hérite de l’interface IUnknown. IBITSExtensionSetup possède également les types de membres suivants :

Méthodes

L’interface IBITSExtensionSetup possède ces méthodes.


IBITSExtensionSetup ::D isableBITSUploads Utilisez la méthode DisableBITSUploads pour désactiver le chargement BITS sur le répertoire virtuel vers lequel pointe l’objet ADSI. Cette méthode définit la propriété d’extension IIS BITSUploadEnabled.
IBITSExtensionSetup ::EnableBITSUploads Utilisez la méthode EnableBITSUploads pour activer le chargement BITS sur le répertoire virtuel vers lequel pointe l’objet ADSI. Cette méthode définit la propriété d’extension IIS BITSUploadEnabled.
IBITSExtensionSetup ::GetCleanupTask Utilisez la méthode GetCleanupTask pour récupérer un pointeur d’interface vers la tâche de nettoyage associée au répertoire virtuel.
IBITSExtensionSetup ::GetCleanupTaskName Utilisez la méthode GetCleanupTaskName pour récupérer le nom de la tâche de nettoyage associée au répertoire virtuel.

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 la fonction ADsGetObject 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;
  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;
}

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

IBITSExtensionSetupFactory

Partager via