다음을 통해 공유

IBitsTokenOptions::GetHelperTokenFlags 메서드(bits4_0.h)

  • 아티클

BITS 전송 작업과 연결된 토큰의 사용 플래그를 반환합니다.

구문

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

매개 변수

[out] pFlags

반환할 사용 플래그를 지정합니다. 이 매개 변수는 다음 값 중 하나로 설정해야 합니다.

값 의미
BG_TOKEN_LOCAL_FILE
0x0001
 이 플래그를 지정하면 도우미 토큰이 사용됩니다.
  • 업로드 작업의 로컬 파일을 열려면
  • 다운로드 작업의 임시 파일을 만들거나 이름을 바꾸려면
  • 업로드-회신 작업의 회신 파일을 만들거나 이름을 바꾸려면
BG_TOKEN_NETWORK
0x0002
 이 플래그를 지정하면 도우미 토큰이 사용됩니다.
  • SMB(서버 메시지 블록) 업로드 또는 다운로드 작업의 원격 파일을 열려면
  • 암시적 NTLM 또는 Kerberos 자격 증명에 대한 HTTP 서버 또는 프록시 챌린지에 대한 응답
애플리케이션은 HTTP를 통해 자격 증명을 보낼 수 있도록 IBackgroundCopyJob2::SetCredentials 메서드를 호출해야 합니다.

반환 값

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

설명

이전 구현에서는 이 메서드를 사용하여 도우미 토큰 플래그를 가져오기 위해 BITS 사용자에게 관리자 권한이 있어야 했습니다. Windows 10 버전 1607부터 관리자가 아닌 BITS 사용자는 이 메서드를 사용하여 소유한 BITS 작업에 대한 도우미 토큰 사용 플래그를 가져올 수 있습니다. 이렇게 변경하면 관리자가 아닌 BITS 사용자(예: NetworkService 계정에서 실행되는 백그라운드 다운로더 서비스)가 도우미 토큰을 효과적으로 사용할 수 있습니다.

특히 IBackgroundCopyJob::QueryInterface 호출 중에 호출자 스레드 토큰의 SID가 작업 소유자 사용자 계정의 SID와 동일한 경우 관리자 권한이 없는 사용자가 도우미 토큰 플래그를 가져올 수 있도록 구현이 변경되었습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7
지원되는 최소 서버 Windows Server 2008 R2
대상 플랫폼 Windows
헤더 bits4_0.h
재배포 가능 파일 SP1이 있는 Windows Vista, WINDOWS Vista SP2가 있는 Windows Vista 및 WINDOWS Server 2008 SP2의 Windows Management Framework

추가 정보

IBitsTokenOptions