Interfaccia IBITSExtensionSetupFactory (bitscfg.h)

Usare l'interfaccia IBITSExtensionSetupFactory per ottenere un puntatore all'interfaccia IBITSExtensionSetup . Usare questa interfaccia solo se si usa l'interfaccia IBITSExtensionSetup in un programma di installazione che installa anche il server BITS. Poiché la cache IIS non contiene le estensioni BITS aggiunte durante l'installazione, le estensioni non sono disponibili tramite la funzione ADSI ADsGetObject . L'interfaccia IBITSExtensionSetupFactory fornisce un metodo GetObject , che accede alle estensioni BITS ed esegue la stessa associazione della funzione ADsGetObject .

Per ottenere un puntatore all'interfaccia IBITSExtensionSetupFactory , chiamare la funzione CoCreateInstance come illustrato in Codice di esempio.

Ereditarietà

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

Metodi

L'interfaccia IBITSExtensionSetupFactory include questi metodi.

 
IBITSExtensionSetupFactory::GetObject

Utilizzare il metodo GetObject per recuperare un puntatore all'interfaccia IBITSExtensionSetup. Questo metodo esegue la stessa associazione eseguita dalla funzione ADSI ADsGetObject.

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

L'esempio seguente illustra come usare l'interfaccia IBITSExtensionSetupFactory 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;
  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;
}

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

IBITSExtensionSetup