Share via

IBackgroundCopyJob::TakeOwnership 메서드(bits.h)

  • 아티클

작업의 소유권을 현재 사용자로 변경합니다.

구문

HRESULT TakeOwnership();

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드 설명
S_OK
 작업 소유권이 변경되었습니다.
BG_E_INVALID_STATE
 작업의 상태는 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다.
BG_E_NEW_OWNER_NO_FILE_ACCESS
 새 소유자는 클라이언트 컴퓨터의 임시 파일에 대한 액세스 권한이 부족합니다. BITS는 소유자의 보안 권한을 사용하여 임시 파일을 만듭니다.
BG_E_NEW_OWNER_DIFF_MAPPING
 로컬 파일에 대한 현재 소유자의 네트워크 드라이브 매핑은 이전 소유자의 네트워크 드라이브 매핑과 다릅니다.
E_ACCESSDENIED
 사용자에게 관리자 권한이 없습니다.

설명

작업의 소유권을 가져오려면 사용자에게 클라이언트에 대한 관리자 권한이 있어야 합니다. Windows Vista에서 사용자는 관리자 권한 상태로 실행해야 합니다. 소유권을 가져온 후 사용자가 관리자 권한 상태에서 실행되는 동안 작업에 대한 향후 업데이트를 수행해야 합니다. 자세한 내용은 사용자 및 네트워크 Connections 참조하세요.

관리자는 속성을 변경하거나 작업에 파일을 추가하기 위해 다른 사용자의 작업에 대한 소유권을 가질 필요가 없습니다. 일반적으로 관리자는 사용자가 작업을 완료할 수 있는 충분한 권한이 없거나 사용자가 로그온되지 않았고 관리자가 작업을 완료해야 하는 경우 TakeOwnership 메서드를 사용합니다.

작업의 소유권이 변경된 후에는 새 소유자가 클라이언트에 로그온한 경우에만 작업이 처리됩니다. IBackgroundCopyJob::GetOwner 메서드를 호출하여 새 소유자의 SID를 검색합니다.

관리자가 소유권 을 가져온 후 작업을 취소하는 경우 관리자가 파일에 대한 쓰기 권한이 없으므로 파일이 분리될 수 있습니다. 이 문제는 로컬 파일 대상이 이전 사용자의 로밍 프로필에 있는 경우에 발생할 수 있습니다.

TakeOwnership 메서드는 설정된 경우 작업에서 자격 증명, 인증서, 사용자 지정 헤더 및 명령줄 알림을 제거합니다.

작업 에서 이벤트 알림을 지정하면 IBackgroundCopyJob::SetNotifyInterface 메서드를 호출한 사용자의 컨텍스트에서 콜백이 실행됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP
지원되는 최소 서버 Windows Server 2003
대상 플랫폼 Windows
헤더 bits.h
라이브러리 Bits.lib
DLL QmgrPrxy.dll

추가 정보

IBackgroundCopyJob::GetOwner