IBITSExtensionSetupFactory 인터페이스(bitscfg.h)

IBITSExtensionSetupFactory 인터페이스를 사용하여 IBITSExtensionSetup 인터페이스에 대한 포인터를 가져옵니다. BITS 서버를 설치하는 설치 프로그램에서 IBITSExtensionSetup 인터페이스를 사용하는 경우에만 이 인터페이스를 사용합니다. IIS 캐시에는 설치 중에 추가된 BITS 확장이 포함되어 있지 않으므로 ADsGetObject ADSI 함수를 사용하여 확장을 사용할 수 없습니다. IBITSExtensionSetupFactory 인터페이스는 BITS 확장에 액세스하고 ADsGetObject 함수와 동일한 바인딩을 수행하는 GetObject 메서드를 제공합니다.

IBITSExtensionSetupFactory 인터페이스에 대한 포인터를 얻으려면 예제 코드와 같이 CoCreateInstance 함수를 호출합니다.

상속

IBITSExtensionSetupFactory 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IBITSExtensionSetupFactory 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IBITSExtensionSetupFactory 인터페이스에는 이러한 메서드가 있습니다.

IBITSExtensionSetupFactory::GetObject GetObject 메서드를 사용하여 IBITSExtensionSetup 인터페이스에 대한 포인터를 검색합니다. 이 메서드는 ADsGetObject ADSI 함수가 수행하는 것과 동일한 바인딩을 수행합니다.

설명

이 인터페이스는 BITS 서버 확장을 설치할 때 서버에 등록됩니다.

Windows Server 2003에서 Windows 구성 요소 마법사를 사용하여 BITS 서버 확장을 설치합니다. 제어판프로그램 추가 또는 제거를 선택합니다. 그런 다음 Windows 구성 요소 추가/제거를 선택하여 Windows 구성 요소 마법사를 표시합니다. BITS 서버 확장은 웹 애플리케이션 서버의 하위 구성 요소인 IIS(인터넷 정보 서비스)의 하위 구성 요소입니다.

예제

다음 예제에서는 IBITSExtensionSetupFactory 인터페이스를 사용하여 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;
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	bitscfg.h
재배포 가능 파일	Windows XP의 BITS 1.5

추가 정보

IBITSExtensionSetup