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 작업을 허용하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10, 버전 1809[데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | bits10_2.h(Bits.h 포함) |
| 라이브러리 | Bits.lib |