다음을 통해 공유

IBackgroundCopyJobHttpOptions2::SetHttpMethod 메서드(bits10_2.h)

  • 아티클

BITS 전송에 사용되는 기본 HTTP 메서드를 재정의합니다.

구문

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

매개 변수

[in] method

형식: LPCWSTR

HTTP 메서드 이름을 포함하는 와이드 문자의 null로 끝나는 상수 문자열에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

BITS를 사용하면 개발자가 기본 메서드가 아닌 HTTP 메서드를 선택할 수 있습니다. 이렇게 하면 HTTP 서버에 대한 일반적인 BITS 요구 사항을 준수하지 않는 서버와 상호 작용하는 BITS의 기능이 증가합니다. 기본값과 다른 HTTP 메서드를 선택할 때 다음 사항을 염두에 두어야 합니다.

  • BITS는 자동으로 작업 우선 순위를 BG_JOB_PRIORITY_FOREGROUND 변경하고 해당 우선 순위가 변경되지 않도록 합니다.
  • 일반적으로 다시 시작 가능한 오류(예: 연결 손실)는 작업을 ERROR 상태로 전환합니다. 개발자는 IBackgroundCopyJob::Resume을 호출하여 작업을 다시 시작할 수 있으며 작업은 처음부터 다시 시작됩니다. BITS 작업 상태에 대한 자세한 내용은 BITS 작업의 수명 주기 를 참조하세요.
  • BITS는 SetHttpMethod를 사용하여 DYNAMIC_CONTENT 또는 ON_DEMAND_MODE 작업을 허용하지 않습니다.
전달한 메서드 이름이 전송 형식의 기본 HTTP 메서드와 일치하는 경우 SetHttpMethod는 아무 작업도 수행하지 않습니다. 예를 들어 다운로드 작업 메서드를 "GET"(기본값)으로 설정하면 작업 우선 순위가 변경되지 않습니다. 작업을 시작하는 IBackgroundCopyJob::Resume 에 대한 첫 번째 호출 전에 HTTP 메서드를 설정해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 1809[데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 bits10_2.h(Bits.h 포함)
라이브러리 Bits.lib

추가 정보

IBackgroundCopyJobHttpOptions2