BITS_JOB_PROPERTY_ID 열거형(bits5_0.h)

  • 아티클

BITS 작업의 속성 ID를 지정하는 상수를 정의합니다.

이 열거형은 BITS_JOB_PROPERTY_VALUE 공용 구조체에서 공용 구조체에 포함된 값의 형식을 결정하는 데 사용됩니다.

Syntax

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

상수

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
값: 1
셀룰러 및/또는 유사한 네트워크를 통해 전송 동작을 제어 하는 데 사용되는 ID입니다. 전송이 진행되는 동안 이 속성이 변경될 수 있습니다. 새 비용 플래그가 즉시 적용됩니다.

이 속성은 BITS_JOB_PROPERTY_VALUEDWORD 필드를 사용합니다.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
값: 2
BITS 작업의 진행률 및 완료에 대한 알림을 받기 위해 CLSID에서 COM 콜백을 등록 하는 데 사용되는 ID입니다. CLSID는 등록된 out-of-process COM 서버와 연결된 클래스를 참조해야 합니다. 이전에 설정된 알림 CLSID를 지우려면 GUID_NULL 설정할 수도 있습니다.

이 속성은 BITS_JOB_PROPERTY_VALUECLsID 필드를 사용합니다.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
값: 3
BITS 작업을 BITS 다운로드에 대한 일반적인 HTTP 요구 사항(HEAD 요청, Content-Length 헤더 및 Content-Range 헤더)을 지원하지 않는 콘텐츠를 다운로드하려는 것으로 표시하는 ID입니다. BITS는 해당 지원 없이 다운로드 작업을 일시 중지하고 다시 시작할 수 없으므로 이러한 유형의 콘텐츠를 다운로드하는 것은 옵트인입니다. 네트워크 연결의 일시적인 손실 또는 시스템 다시 부팅과 같은 이유로 이 속성을 사용하는 작업이 중단되면 BITS는 중단된 위치를 다시 시작하는 대신 처음부터 다운로드를 다시 시작합니다. 또한 BITS는 동적 다운로드에 대한 대역폭 사용을 제한할 수 없습니다. BITS는 BG_JOB_PRIORITY_FOREGROUND 할당되지 않은 작업에 대해 할당되지 않은 전송을 수행하지 않으므로 일반적으로 동적 콘텐츠를 허용하는 작업 설정을 사용할 때마다 해당 우선 순위를 설정해야 합니다.

이 속성은 BITS_JOB_PROPERTY_VALUE사용 필드를 사용합니다. 이 속성은 BG_JOB_TYPE_DOWNLOAD 작업에 대해서만 지원됩니다. FILE_RANGES 사용하는 다운로드에는 지원되지 않습니다. 이 속성은 작업에서 처음으로 Resume 이 호출되기 전에만 설정할 수 있습니다.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
값: 4
강력한 안정성 보장이 필요하지 않은 BITS 작업을 표시하는 ID입니다. 이 속성을 사용하도록 설정하면 BITS가 일반적으로 정기적으로 수행하는 정상적인 작업 진행률에 대한 정보가 유지되지 않도록 합니다. 전송 중에 전원 손실과 같은 예기치 않은 종료가 발생하면 BITS가 진행 상황을 잃게 됩니다.

평소처럼 중단된 위치에서 다시 시작하는 대신 처음부터 작업을 다시 시작합니다. 그러나 작업 수명 동안 BITS가 만드는 디스크 쓰기의 수도 줄어들어 더 작은 작업의 성능을 향상시킬 수 있습니다.

또한 이 속성을 사용하면 임시 파일로 다운로드하고 전송이 완료되면 임시 파일을 최종 대상으로 이동하는 대신 BITS가 대상 파일에 직접 다운로드됩니다. 즉, 작업이 취소되거나 심각한 오류 조건이 발생하는 경우 BITS에서 부분적으로 다운로드한 콘텐츠를 클린 않습니다. BITS 호출자는 생성되는 경우 대상 파일을 정리할 책임이 있습니다. 그러나 디스크 오버헤드도 약간 줄어듭니다.

이 속성은 작은 작업(1MB 미만)이 많고 전원 손실 또는 기타 예기치 않은 종료 이벤트에 대한 안정성이 필요하지 않은 시나리오에만 권장됩니다. 성능 절감은 일반적으로 적은 수의 작업이나 더 큰 작업의 경우 중요하지 않습니다.

이 속성은 BITS_JOB_PROPERTY_VALUE사용 필드를 사용합니다. 이 속성은 BG_JOB_TYPE_DOWNLOAD 작업에 대해서만 지원됩니다. 이 속성은 작업에 파일을 추가하기 전에 설정할 수 있습니다.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
값: 5
BITS 작업의 최대 바이트 수를 표시하는 ID는 총 다운로드할 수 있습니다. 이 속성은 미리 다운로드할 파일의 크기를 확인할 수 없지만 가능한 총 다운로드 크기를 제한하려는 BITS_JOB_PROPERTY_DYNAMIC_CONTENT 사용하기 위한 것입니다.

이 속성은 BITS_JOB_PROPERTY_VALUE사용 필드를 사용합니다. 이 속성은 BG_JOB_TYPE_DOWNLOAD 작업에 대해서만 지원됩니다. 이 속성은 작업에서 처음으로 Resume 이 호출되기 전에만 설정할 수 있습니다.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
값: 7
프록시 서버에 대한 요청에 기본 자격 증명을 포함하려는 것으로 BITS 작업을 표시하는 ID입니다. 이 속성을 사용하도록 설정하는 것은 BITS가 사용자를 대신하여 하는 요청에 대해 WinHTTP 보안 수준WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM 설정하는 것과 같습니다. 사용자 BITS는 에서 저장된 자격 증명을 검색합니다. 대신 네트워크 요청을 하는 자격 증명과 동일합니다. BITS는 네트워크 도우미 토큰을 명시적으로 제공하지 않는 한 일반적으로 작업 소유자의 자격 증명을 사용합니다. 이 경우 BITS는 네트워크 도우미 토큰의 자격 증명을 사용합니다.

이 속성은 BITS_JOB_PROPERTY_VALUE대상 필드를 사용합니다. 그러나 BG_AUTH_TARGET_PROXY 대상만 지원됩니다.
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
값: 9
BITS JobNotification 및 FileRangesTransferred 알림의 타이밍을 제어하는 데 사용되는 ID입니다. 이 속성을 사용하도록 설정하면 사용자에게 다른 속도로 알림을 받을 수 있습니다. 전송이 진행되는 동안 이 속성이 변경될 수 있습니다. 그러나 새 속도는 즉시 적용되지 않을 수 있습니다. 기본값은 500밀리초입니다.

이 속성은 BITS_JOB_PROPERTY_VALUEDWORD 필드를 사용합니다.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
값: 10
작업이 주문형 모드인지 여부를 제어하는 데 사용되는 ID입니다. 주문형 작업을 사용하면 앱이 처음부터 끝까지 다운로드하는 대신 파일 다운로드에 대한 특정 범위를 요청할 수 있습니다. 기본값은 FALSE입니다. 작업이 주문형이 아닙니다. 범위는 IBackgroundCopyFile6::RequestFileRanges 메서드를 사용하여 요청됩니다.

이 속성은 BITS_JOB_PROPERTY_VALUE사용 필드를 사용합니다.

BITS_JOB_PROPERTY_ON_DEMAND_MODE 작업에 대한 요구 사항은 전송이 BG_JOB_TYPE_DOWNLOAD 작업이어야 한다는 것입니다. 작업은 DYNAMIC 이 아니어야 하며 서버는 HTTP 또는 HTTPS 서버여야 하며 범위 지원에 대한 서버 요구 사항을 모두 충족해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
지원되는 최소 서버 Windows Server 2012
머리글 bits5_0.h

추가 정보