IBITSExtensionSetup 인터페이스(bitscfg.h)

IBITSExtensionSetup 인터페이스를 사용하여 가상 디렉터리에 대한 BITS 업로드를 사용하거나 사용하지 않도록 설정합니다.

이 인터페이스는 ADSI 확장입니다. 이 인터페이스에 대한 포인터를 얻으려면 예제 코드와 같이 ADsGetObject ADSI 함수를 호출합니다.

BITS 서버도 설치하는 설치 프로그램에서 이 인터페이스를 사용하는 경우 ADsGetObject 함수를 호출하는 대신 IBITSExtensionSetupFactory::GetObject 메서드를 호출하여 이 인터페이스에 대한 포인터를 가져와야 합니다.

상속

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

메서드

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

IBITSExtensionSetup::D isableBITSUploads DISABLEBITSUploads 메서드를 사용하여 ADSI 개체가 가리키는 가상 디렉터리에서 BITS 업로드를 사용하지 않도록 설정합니다. 이 메서드는 BITSUploadEnabled IIS 확장 속성을 설정합니다.
IBITSExtensionSetup::EnableBITSUploads EnableBITSUploads 메서드를 사용하여 ADSI 개체가 가리키는 가상 디렉터리에서 BITS 업로드를 사용하도록 설정합니다. 이 메서드는 BITSUploadEnabled IIS 확장 속성을 설정합니다.
IBITSExtensionSetup::GetCleanupTask GetCleanupTask 메서드를 사용하여 가상 디렉터리에 연결된 정리 작업에 대한 인터페이스 포인터를 검색합니다.
IBITSExtensionSetup::GetCleanupTaskName GetCleanupTaskName 메서드를 사용하여 가상 디렉터리에 연결된 정리 작업의 이름을 검색합니다.

설명

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

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

예제

다음 예제에서는 ADsGetObject 함수를 사용하여 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;
}

요구 사항

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

추가 정보

IBITSExtensionSetupFactory