Interfaccia IBITSExtensionSetup (bitscfg.h)

Usare l'interfaccia IBITSExtensionSetup per abilitare o disabilitare i caricamenti BITS in una directory virtuale.

Questa interfaccia è un'estensione ADSI. Per ottenere un puntatore a questa interfaccia, chiamare la funzione ADSI ADsGetObject , come illustrato nel codice di esempio.

Se si usa questa interfaccia da un programma di installazione che installa anche il server BITS, è necessario chiamare il metodo IBITSExtensionSetupFactory::GetObject per ottenere un puntatore a questa interfaccia anziché chiamare la funzione ADsGetObject .

Ereditarietà

L'interfaccia IBITSExtensionSetup eredita dall'interfaccia IUnknown . IBITSExtensionSetup include anche questi tipi di membri:

Metodi

L'interfaccia IBITSExtensionSetup dispone di questi metodi.

IBITSExtensionSetup::D isableBITSUploads Utilizzare il metodo DisableBITSUploads per disabilitare il caricamento BITS nella directory virtuale in cui punta l'oggetto ADSI. Questo metodo imposta la proprietà dell'estensione IIS BITSUploadEnabled.
IBITSExtensionSetup::EnableBITSUploads Utilizzare il metodo EnableBITSUploads per abilitare il caricamento BITS nella directory virtuale in cui punta l'oggetto ADSI. Questo metodo imposta la proprietà dell'estensione IIS BITSUploadEnabled.
IBITSExtensionSetup::GetCleanupTask Utilizzare il metodo GetCleanupTask per recuperare un puntatore di interfaccia all'attività di pulizia associata alla directory virtuale.
IBITSExtensionSetup::GetCleanupTaskName Utilizzare il metodo GetCleanupTaskName per recuperare il nome dell'attività di pulizia associata alla directory virtuale.

Commenti

Questa interfaccia viene registrata nel server quando si installa l'estensione del server BITS.

In Windows Server 2003 usare la Creazione guidata componenti di Windows per installare l'estensione server BITS. In Pannello di controllo selezionare Installazione applicazioni. Selezionare quindi Aggiungi/Rimuovi componenti di Windows per visualizzare la Creazione guidata componenti di Windows. L'estensione server BITS è un componente secondario di Internet Information Services (IIS) che è un sotto-componente del server applicazioni Web.

Esempio

Nell'esempio seguente viene illustrato come usare la funzione ADsGetObject per ottenere un puntatore all'interfaccia 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;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bitscfg.h
Componente ridistribuibile	BITS 1.5 in Windows XP

Vedi anche

IBITSExtensionSetupFactory