Compartir a través de

Interfaz IBITSExtensionSetupFactory (bitscfg.h)

  • Artículo

Use la interfaz IBITSExtensionSetupFactory para obtener un puntero a la interfaz IBITSExtensionSetup . Use esta interfaz solo si usa la interfaz IBITSExtensionSetup en un programa de instalación que también instala el servidor BITS. Dado que la memoria caché de IIS no contiene las extensiones de BITS agregadas durante la instalación, las extensiones no están disponibles mediante la función ADSI ADsGetObject . La interfaz IBITSExtensionSetupFactory proporciona un método GetObject , que accede a las extensiones BITS y realiza el mismo enlace que la función ADsGetObject .

Para obtener un puntero a la interfaz IBITSExtensionSetupFactory , llame a la función CoCreateInstance como se muestra en Código de ejemplo.

Herencia

La interfaz IBITSExtensionSetupFactory hereda de la interfaz IUnknown . IBITSExtensionSetupFactory también tiene estos tipos de miembros:

Métodos

La interfaz IBITSExtensionSetupFactory tiene estos métodos.

 
IBITSExtensionSetupFactory::GetObject

Use el método GetObject para recuperar un puntero a la interfaz IBITSExtensionSetup. Este método realiza el mismo enlace que realiza la función ADSI ADsGetObject.

Comentarios

Esta interfaz se registra en el servidor al instalar la extensión de servidor BITS.

En Windows Server 2003, use el Asistente para componentes de Windows para instalar la extensión de servidor BITS. En Panel de control, seleccione Agregar o quitar programas. A continuación, seleccione Agregar o quitar componentes de Windows para mostrar el Asistente para componentes de Windows. La extensión de servidor BITS es un subcomponente de Internet Information Services (IIS) que es un subcomponente del servidor de aplicaciones web.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la interfaz IBITSExtensionSetupFactory para obtener un puntero a la interfaz 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 Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2003
Plataforma de destino Windows
Encabezado bitscfg.h
Redistribuible BITS 1.5 en Windows XP

Consulte también

IBITSExtensionSetup